ApiToll

← Catalog · Country Data

Country Data Sandbox.

Test the country-data integration on Base Sepolia. Five real countries with full canonical records. Resolver accepts ISO-2, ISO-3, or name. Switch to production by removing /sandbox/ from the URL.

How it differs from production

Production endpoint
GET /v1/country/:iso2
Sandbox endpoint
GET /v1/sandbox/country/:iso2
Network
Base Sepolia testnet (eip155:84532)
Asset
Test USDC at 0x036CbD53842c5426634e7929541eC2318f3dCF7e
Faucet
alchemy.com/faucets/base-sepolia
Price
$0.001 in test USDC per request — same nominal as production
Dataset
5 curated countries with real data: US, GB, ZA, JP, BR
Response
Identical schema to production. meta.sandbox: true tells you which side you're on.
Bazaar listing
None — only the production endpoint lists at agentic.market

Curated set

What you can ask for.

Anything else returns a 404 with the available list and a pointer to mainnet for the full dataset.

US
United States
GB
United Kingdom
ZA
South Africa
JP
Japan
BR
Brazil

Same accepted by both /v1/sandbox/country/:iso2 and /v1/sandbox/country/resolve/:input. Production covers 250 ISO countries.

Six steps

From zero to graduated.

  1. Get test USDC.

    Visit the Alchemy Base Sepolia faucet. Drip a few cents to your test wallet.

  2. Try the unpaid call.

    See the 402 challenge: 

    curl -i https://apitoll.io/v1/sandbox/country/US
    The response carries the network, asset, payTo, and amount.

  3. Sign an EIP-3009 authorization.

    Put the signed payload in the X-PAYMENT header (base64-encoded JSON). Most agent SDKs (@x402/axios, x402-fetch) handle this automatically.

  4. Retry with payment.

    You'll get the data back, plus an x-payment-response settlement receipt header.

  5. Iterate.

    Test against the curated set above until your integration is solid.

  6. Graduate.

    Remove /sandbox/ from the URL. Same response shape, real USDC settlement on Base mainnet, full dataset.

Why a sandbox exists

Country data is reference data — once you trust the response shape, you're done. The sandbox lets you validate the schema without burning real USDC on what amounts to a syntax check.

The sandbox uses the same code path as production. If your agent works against https://apitoll.io/v1/sandbox/country/US, removing /sandbox/ is the only change needed to graduate to https://apitoll.io/v1/country/US.