ApiToll

← Catalog · BIN Lookup

BIN Lookup Sandbox.

Test the BIN lookup integration on Base Sepolia. Ten curated test BINs covering all four major schemes and five countries. Same JSON shape as production. Switch to production by removing /sandbox/ from the URL.

How it differs from production

Production endpoint
GET /v1/bin/:bin
Sandbox endpoint
GET /v1/sandbox/bin/:bin
Network
Base Sepolia testnet (eip155:84532)
Asset
Test USDC at 0x036CbD53842c5426634e7929541eC2318f3dCF7e
Faucet
alchemy.com/faucets/base-sepolia
Price
$0.002 in test USDC per request — same nominal as production
Dataset
10 curated BINs covering Visa, Mastercard, Amex, Discover; debit, credit, charge; US, GB, DE, IE, JP
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.

431940
Visa Debit · Bank of Ireland (IE)
424242
Visa Credit · Stripe Test Bank (US) — the famous one
555555
Mastercard Credit · generic test issuer (US)
378282
American Express Charge (US)
601100
Discover Credit (US)
400000
Visa Credit · generic Visa test
521564
Mastercard Debit · Capital One (US)
492181
Visa Debit · NatWest (GB)
530155
Mastercard Credit · Deutsche Bank (DE)
374711
American Express Charge · Japan

Anything else returns a 404 with the available list. The full 343,063 BIN database is mainnet-only.

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/bin/431940
    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

x402 is new. The buyer-side experience — signing payments, handling 402 retries, waiting for settlement — is genuinely tricky to get right the first time. We'd rather you spend test USDC iterating than lose real money on a misconfigured client.

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