ERC-20 Token Balance Snapshot

Machine-to-Machine Conformance API · erc20-balance

$0.005 / call 3 free calls/day No signup

Raw + formatted ERC-20 balanceOf for an address at any token contract on Base. Decimals read on-chain. Preflighted so you never pay during an RPC outage.

Honest Scope Guarantee

Reads public Base chain state via RPC, preflighted so you never pay during an outage. It proves what is on-chain — not who controls a key or what happens off-chain.

Run in Playground (Free) Buy Card Credits Agent Quickstart

Quickstart & Execution

cURL (20 Free Calls/Day • Zero Authentication Required)

curl -X POST https://api.code402.dev/v1/tools/erc20-balance/call \
  -H "content-type: application/json" \
  -d '{"address":"0xc59c85e661d34084a7769f955d17fd38254a6235","token_address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}'

No API key needed for the free daily tier. When daily quota exhausts, the endpoint replies with HTTP 402 Payment Required specifying the exact USDC amount. Machines sign an EIP-3009 transfer on Base L2; human engineers buy card credits. Every paid execution returns a cryptographically signed XDR-1 receipt for zero-knowledge audit trails.

Input Parameters

Field	Type	Meaning & Constraints
`address` (REQUIRED)	`string`	Holder EVM address, 0x-prefixed.
`token_address` (REQUIRED)	`string`	ERC-20 token contract address, 0x-prefixed.
`decimals`	`number`	Token decimals override (optional).

Response Format

Deterministic JSON payload fields: tool, valid, address, token_address, balance_raw, decimals, decimals_source, balance, reason, retryable, scope. Paid responses also carry an offline-verifiable receipt object (XDR-1, secp256k1 signature recoverable to the authorized signer).

Related Conformance Tools

aci-trust-lookup dip-file-dispute pod-verify-delivery csp-commitment-create iso20022-validate iso20022-to-x402-intent iban-check lei-check vat-mod97-check company-number-format swift-bic-check aba-routing-check ein-format-check ifsc-check abn-check gstin-check cnpj-check uscc-check japan-corp-check kra-pin-check rfc-check iso4217-currency-check upi-vpa-check pan-format-check uae-trn-check isin-check sedol-check isbn-check ean13-check luhn-check e164-check pre-disbursement-guard vendor-onboarding-pack rent-deposit-guard rental-listing-risk rental-verdict india-supplier-check china-supplier-check japan-supplier-check latam-supplier-check gulf-supplier-check africa-supplier-check settlement-history-check balance-check tx-activity block-info ofac-sdn-check simulate-spend-sentinel create-ap2-pilot create-b2b-invoice get-b2b-invoice calculate-fx-savings fx-spot-price-oracle quote-3rd-party-insurance bind-insurance-policy list-approved-insurers batch-validate context-distill crypto-ticker instant-json-schema-verifier clean-markdown-scraper