{"uid":"cap_JCoJ3A9mXxZBvZ_GKopZb","slug":"erc20-token-balance-lookup-fe07c0cb","name":"ERC20 Token Balance Lookup","description":"ERC20 token balance for any wallet - USDC, USDT, DAI or any token - via balanceOf. Returns the raw amount and the decimals so you can format it. Via eth_call (balanceOf).","url":"https://flat-rate-llm.kikoribera03.workers.dev/v1/evm/erc20-balance?utm_source=zero.xyz","method":"GET","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-10-30T12:31:22.051Z","isFirstParty":false,"canonicalSlug":"erc20-token-balance-lookup-fe07c0cb"}