Card BIN Lookup x402

Pay per call · no API key

Card BIN Lookup x402

Instant card BIN intelligence. Bank, brand, country, type, funding & more via x402.

Your agent pays a few cents in USDC per request over x402. No account, no subscription, no key to rotate — and a failed lookup is never charged.

Call it in three steps

Any x402 v2 client works. This uses @x402/fetch with a viem wallet.

Step 1

See the terms

An unpaid request returns 402 with the price and accepted chains.

curl -i https://binx402.com/v1/bin?bin=448590
Step 2

Install a client

Wraps fetch so payment is signed and retried for you.

npm i @x402/fetch viem
Step 3

Pay and call

The wrapped fetch settles payment and returns the data.

const f = wrapFetchWithPayment(fetch, wallet);
await f("https://binx402.com/v1/bin?bin=448590");

Endpoints

Every route accepts POST with a JSON body or GET with query parameters. Fields and response shapes are declared in openapi.json.

POST /v1/bin

resolve issuer, scheme, type and country for a card BIN

  • binrequiredThe first 6 to 8 digits of a payment card, e.g. "448590".
$0.01 per call

POST /v1/verify

assess a BIN together with IP, phone, IBAN and address

  • binrequiredCard BIN. Required.
  • ipIPv4 or IPv6 address to cross-check against the BIN country.
  • phonePhone number in E.164 form, e.g. "+13023309010".
  • ibanIBAN to validate.
  • countryISO 3166-1 alpha-2 country code.
  • company
  • vatVAT registration number.
  • address
  • state
  • postcode
$0.01 per call

Payment

Priced in USDC and settled over x402. Pick whichever chain your wallet holds — both are offered on every paid route at the same price.

Price per call$0.01 USDC
Base baseeip155:8453
0x1C2Eb89273135175Ae7F24A7C93f0bF5D61Eb793
Solanasolana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
H6YQh5EHWdmu56j8KUWjVvR7M6yvUhHM2ekydPHEs9sR
Protocolx402 v2 · scheme exact
Not charged whenthe request is malformed (400), the provider fails (502/503), or the lookup times out (504). Only a 2xx response is billed.

Questions

What is a card BIN?

The BIN, or Bank Identification Number, is the first six to eight digits of a payment card. It identifies the issuing bank, the card scheme, and the card's type and country, which is why it is used for payment routing and fraud screening.

Do I need an API key?

No. There is no account, key or subscription. Requests are paid per call in USDC over the x402 protocol, so any agent or client with a funded wallet can call the API immediately.

What does a BIN lookup cost?

Each lookup costs $0.01 in USDC, payable on Base or Solana at the same price. Failed lookups are never charged — only a successful response settles payment.

Which data does a lookup return?

Issuer name, website and phone, card scheme and brand, card type such as credit or debit, product level, currency, and full country detail including ISO codes.