{"uid":"cap_72wulKhUxKxrYrIiPTzGl","slug":"erc20-token-balance-lookup-b3e6b431","name":"ERC20 Token Balance Lookup","description":"Free APEX on X1, and free USDC plus APEX on Arc, three times a day. No gas, no sign-up. Plus a swap, a screener, APEX City and token checks.","url":"https://apexfaucet.xyz/api/x402/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","queryParams"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["address","token"],"properties":{"chain":{"enum":["ethereum","base","arc","bnb"],"type":"string","description":"Chain to read: ethereum, base, arc or bnb. Default ethereum."},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC-20 token contract."},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Wallet whose balance to read."}}}}},"output":{"type":"object"}}},"responseSchema":{"type":"json","schema":{"type":"object","properties":{"ok":{"type":"boolean"},"data":{"type":"object"},"paid":{"type":"number"}}},"example":{"ok":true,"data":{"ok":true,"raw":"37192124","name":"USD Coin","block":26184706,"chain":"ethereum","token":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","symbol":"USDC","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","balance":"37.192124","decimals":6,"blockTime":"2026-10-13T16:16:23.000Z"},"paid":0.001}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0sv7bQHHG1uoOb3EC8y8Y","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","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 for a given wallet address on Ethereum, Base, Arc, or BNB Chain","exampleAgentPrompt":"What's the USDC balance of wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum? The USDC contract is 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48.","exampleUseCases":[{"title":"DeFi portfolio balance checker","prompt":"Check how much USDC the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 holds on Base — use the USDC contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913."},{"title":"Token airdrop eligibility verification","prompt":"I need to verify whether wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B holds any of the APEX token at contract 0x52A8845DF664D76C69d2EEa607CD793565aF42B8 on Ethereum — what's their balance?"},{"title":"Cross-chain wallet monitoring","prompt":"Can you look up the balance of token 0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E for wallet 0x1234567890abcdef1234567890abcdef12345678 on BNB Chain?"}],"resultDescription":"Returns a JSON object with ok status, and a data object containing the human-readable balance (with decimals applied), the raw integer balance, token name, symbol, decimals, the chain queried, the block number and timestamp at which the balance was read, plus the wallet and token contract addresses. Also includes the amount paid for the API call.","failureModes":["Invalid wallet address format (must be 0x + 40 hex chars) returns an error","Invalid token contract address format returns an error","Unsupported chain name returns an error","Token contract does not exist on specified chain may return zero balance or error","Network timeout or RPC node failure may return a non-ok response"],"whenToPreferThis":"Use this endpoint when you need a quick, cheap ($0.001) on-chain ERC-20 token balance lookup across Ethereum, Base, Arc, or BNB Chain without setting up your own RPC infrastructure. Ideal for agents that need real-time wallet token holdings as part of DeFi workflows, portfolio checks, or eligibility verification.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T12:57:48.152Z","isFirstParty":false,"canonicalSlug":"erc20-token-balance-lookup-b3e6b431"}