{"uid":"cap_5ebTyH6B3noFuLR-6RNXp","slug":"erc-20-token-balance-lookup-by-wallet-3992832e","name":"ERC-20 Token Balance Lookup by Wallet","description":"Balance of one ERC-20 token for one wallet on Base, Ethereum, Arbitrum, BSC, Polygon, Optimism or Avalanche with symbol and decimals. Cheapest way to confirm a deposit. $0.001.","url":"https://api.agent-data.workers.dev/api/v1/evm/token/balance?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["token","address"],"properties":{"chain":{"type":"string"},"token":{"type":"string"},"address":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"base","symbol":"USDC","balance":1.5,"decimals":6,"raw_balance":"1500000"}},"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_KvPtdLv8dfi7DaiaYADwj","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 balance, symbol, and decimals of a specific ERC-20 token for a given wallet address on a supported EVM chain.","exampleAgentPrompt":"What's the USDC balance for wallet 0xAbC...123 on Base? I need to confirm a deposit came through.","exampleUseCases":[{"title":"Confirm customer crypto deposit","prompt":"Can you check whether the USDC deposit from wallet 0x1234...abcd has arrived on Polygon? The expected amount was 500 USDC."},{"title":"Verify DeFi collateral position","prompt":"What's the WETH balance for address 0xDeF...789 on Arbitrum right now? I need to know if they have enough collateral."},{"title":"Check airdrop token receipt","prompt":"Did the ARB token airdrop land in my wallet 0xabc...999 on Arbitrum? Can you check the balance and show me the raw amount?"}],"resultDescription":"A JSON object containing the chain name, token symbol, human-readable balance (float), token decimals, and raw balance string (e.g. {chain:'base', symbol:'USDC', balance:1.5, decimals:6, raw_balance:'1500000'}).","failureModes":["Invalid or unsupported chain name returns an error","Malformed wallet address or token contract address returns an error or zero balance","Token contract address not deployed on the specified chain returns no data","Network congestion or RPC timeouts may cause delayed responses","Unsupported chain outside Base/Ethereum/Arbitrum/BSC/Polygon/Optimism/Avalanche returns an error"],"whenToPreferThis":"Use this endpoint when you need to check the balance of a single specific ERC-20 token for one wallet address on a supported EVM chain — especially for lightweight deposit confirmation where cost matters ($0.001/call). Prefer this over a full multi-token wallet scan when only one token is relevant, or when you need symbol and decimals alongside the balance.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-14T18:36:07.949Z","isFirstParty":false,"canonicalSlug":"erc-20-token-balance-lookup-by-wallet-3992832e"}