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".
Pay per call · no API key
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.
Any x402 v2 client works. This uses @x402/fetch with a viem wallet.
An unpaid request returns 402 with the price and accepted chains.
curl -i https://binx402.com/v1/bin?bin=448590
Wraps fetch so payment is signed and retried for you.
npm i @x402/fetch viem
The wrapped fetch settles payment and returns the data.
const f = wrapFetchWithPayment(fetch, wallet);
await f("https://binx402.com/v1/bin?bin=448590");
Every route accepts POST with a JSON body or GET with query parameters. Fields and response shapes are declared in openapi.json.
resolve issuer, scheme, type and country for a card BIN
binrequiredThe first 6 to 8 digits of a payment card, e.g. "448590".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.companyvatVAT registration number.addressstatepostcodePriced 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.02 USDC |
|---|---|
| Base base | eip155:84530x1C2Eb89273135175Ae7F24A7C93f0bF5D61Eb793 |
| Solana | solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpH6YQh5EHWdmu56j8KUWjVvR7M6yvUhHM2ekydPHEs9sR |
| Protocol | x402 v2 · scheme exact |
| Not charged when | the request is malformed (400), the provider fails (502/503), or the lookup times out (504). Only a 2xx response is billed. |