# ApiToll — machine-readable index
# https://apitoll.io

apitoll.io is a pay-per-request API gateway. Payment is via the x402 protocol
in USDC on Base. AI agents can pay autonomously; no signup, no API keys.

## Active services

### BIN Lookup
- Endpoint:      GET https://apitoll.io/v1/bin/:bin
- Input:         6-8 numeric digits (the BIN prefix). Longer input is REJECTED.
                 This API is deliberately out of PCI scope — do not send full card numbers.
- Price:         0.002 USDC per request (2000 base units)
- Network:       base-sepolia (eip155:84532)
- Asset:         USDC (0x036CbD53842c5426634e7929541eC2318f3dCF7e)
- Pay-to:        0x02e1ff454E84bDAc10B0533D2Ea266f6Bcb7BD40
- Scheme:        x402 v2 "exact" (EIP-3009 transferWithAuthorization — gasless for the payer)
- Response:      JSON with scheme, type, issuer, country (see /.well-known/agent.json schema)
- Data source:   iannuttall/binlist-data (343,063 records, CC-BY-4.0)

## Example (unpaid — returns 402 challenge)

    curl -i https://apitoll.io/v1/bin/431940

The 402 response carries the payment requirements. Sign an EIP-3009 authorization
for the quoted amount/recipient/nonce, put the signed payload in the X-PAYMENT
header (base64 JSON), retry. The response returns with an x-payment-response
settlement receipt.

## Discovery

- https://apitoll.io/.well-known/mcp.json      (MCP server manifest)
- https://apitoll.io/.well-known/agent.json    (A2A agent card)
- https://apitoll.io/health                    (liveness / stats)

## License

This response format and the apitoll.io service are proprietary to ApiToll.
BIN data is redistributed from iannuttall/binlist-data under CC-BY-4.0.