{"uid":"cap_1L62elRBn4T82oyvi3ATG","slug":"brainiac-erc-20-token-balance-lookup-d5aa2b2a","name":"BRAINIAC ERC-20 Token Balance Lookup","description":"Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.","url":"https://www.brainiac.software/api/v1/chain-data/token/erc20-balance?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"blockNumber":{"type":"integer","maximum":9007199254740991,"minimum":0},"tokenAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"walletAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}}},"responseSchema":{"type":"json","example":{"source":{"url":"https://mainnet.base.org","status":"OK"},"balance":"0x0000000000000000000000000000000000000000000000000000000000000000","chainId":8453,"blockNumber":"latest","retrievedAt":"2026-11-07T12:08:59.747Z","tokenAddress":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","walletAddress":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913","balanceDecimal":"0"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tQLAcqj2tHWv_UzScMKbv","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the ERC-20 token balance of a given wallet address at a specified block number on-chain","exampleAgentPrompt":"What's the USDC balance (0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 right now?","exampleUseCases":[{"title":"DeFi portfolio snapshot","prompt":"Can you check how many WETH tokens (0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2) the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 was holding at block 19000000?"},{"title":"Token-gating eligibility check","prompt":"Does wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B hold at least some amount of the governance token at 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 right now — can you pull the current balance?"},{"title":"Historical airdrop snapshot audit","prompt":"I need to verify the token balance of 0x742d35Cc6634C0532925a3b844Bc454e4438f44e for the token contract 0x6B175474E89094C44Da98b954EedeAC495271d0F at block 18500000 for an airdrop eligibility audit."}],"resultDescription":"A JSON response containing the ERC-20 token balance for the specified wallet address and token contract, optionally at a historical block number. The balance is returned as an on-chain value reflecting the token holdings at that point in time.","failureModes":["Invalid wallet address format (must be 0x-prefixed 40-character hex) returns an error","Invalid token contract address format returns an error","Block number exceeding safe integer maximum is rejected","Non-existent or non-ERC-20 contract address may return zero or error","Payment failure via x402/USDC on Base results in 402 response and no data","Network or RPC node issues may cause timeouts or stale data"],"whenToPreferThis":"Use this endpoint when you need a simple, accountless, pay-per-call ERC-20 token balance lookup without managing API keys or subscriptions. It is ideal for agents that need occasional on-chain balance checks without integrating a full blockchain node or indexer. The x402 micropayment model (0.01 USDC per call) makes it cost-effective for low-frequency queries. Prefer alternatives like Alchemy or Infura if you need high-volume queries, WebSocket subscriptions, or multi-chain support beyond what BRAINIAC offers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-16T00:30:19.354Z","isFirstParty":false,"canonicalSlug":"brainiac-erc-20-token-balance-lookup-d5aa2b2a"}