{"uid":"cap_JCoJ3A9mXxZBvZ_GKopZb","slug":"erc20-token-balance-lookup-fe07c0cb","name":"ERC20 Token Balance Lookup","description":"60 paid endpoints with no metering, no API key and no account. Each endpoint has one flat price per call, whatever the size of the request: LLM completions with automatic failover across several large models, read-only EVM tooling over Base, Ethereum, Polygon, Arbitrum and Optimism, and pure crypto utilities that touch no network.","url":"https://flat-rate-llm.kikoribera03.workers.dev/v1/evm/erc20-balance","method":"POST","headers":{},"bodySchema":{"type":"object","required":["token","address"],"properties":{"chain":{"type":"string","description":"base | ethereum | polygon | arbitrum | optimism."},"token":{"type":"string","description":"ERC20 contract address."},"address":{"type":"string","description":"Wallet to look up."}}},"responseSchema":{"type":"object","properties":{"raw":{"type":"string"},"amount":{"type":"number"},"symbol":{"type":"string"},"decimals":{"type":"number"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8zunM_qpPx791kOTUMyQ8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the raw and formatted token balance for any ERC20 token (USDC, USDT, DAI, etc.) held by a given wallet address on EVM-compatible chains via balanceOf.","exampleAgentPrompt":"What's the USDC balance for wallet 0xAbC...123 on Base? I need the formatted amount and the decimals so I can display it correctly.","exampleUseCases":[{"title":"Pre-trade balance verification","prompt":"Before I swap, check how much USDT is sitting in wallet 0xDe...456 on Ethereum — give me the formatted amount and raw value so I can confirm there's enough to cover the trade."},{"title":"DeFi portfolio snapshot","prompt":"What's the DAI balance for 0xFa...789 on Polygon right now? I want the symbol, decimals, and the actual human-readable amount."},{"title":"Airdrop eligibility check","prompt":"Check whether wallet 0x12...ABC holds any of this ERC20 token at contract 0x99...EEE on Arbitrum — return the balance and decimals so I can see if it qualifies."}],"resultDescription":"Returns a JSON object with four fields: 'raw' (the integer balance as a string, straight from balanceOf), 'amount' (the decimal-adjusted human-readable number), 'symbol' (the token ticker, e.g. USDC), and 'decimals' (the token's decimal places, e.g. 6 for USDC). Together these let an agent display or compute with the balance without further on-chain calls.","failureModes":["Invalid or non-checksummed wallet address returns a validation error","Non-existent or non-ERC20 contract address causes eth_call to revert or return zero","Unsupported chain identifier returns an error listing valid options","Network congestion or RPC timeout may cause slow or failed responses","Wallet with zero balance returns raw '0' and amount 0, which is valid but may be misread as an error"],"whenToPreferThis":"Choose this endpoint when you need a quick, no-auth, pay-per-call ERC20 balance check across major EVM chains (Base, Ethereum, Polygon, Arbitrum, Optimism) and want both the raw balanceOf integer and the formatted decimal amount in one response. Ideal for agents that need to verify holdings before a transaction, display a portfolio balance, or gate logic on token ownership without setting up an RPC connection or API key.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:49:57.302Z","isFirstParty":false}