{"uid":"cap_wQ-EzMew0nvo_IuBxgAC2","slug":"erc-20-token-balance-lookup-base-ethereum-50f8bc82","name":"ERC-20 Token Balance Lookup (Base/Ethereum)","description":"Pay-per-call website uptime/latency/TLS checks and fetch-to-Markdown, measured from Hub Europe (Germany). USDC on Base via x402. No account or API key.","url":"https://arandar.ccwu.cc:8443/v1/chain/erc20-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":["chain","token","address"],"properties":{"chain":{"type":"string","example":"base","description":"base or ethereum"},"token":{"type":"string","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"ERC-20 contract address"},"address":{"type":"string","example":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","description":"0x EVM address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"raw":"12500000","symbol":"USDC","balance":"12.5","decimals":6}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_aK7Q25EPc3EBGMFPlxmq9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","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 Base or Ethereum, paid per-call via x402/USDC with no account required.","exampleAgentPrompt":"What's the USDC balance for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base — use the ERC-20 contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?","exampleUseCases":[{"title":"DeFi portfolio balance snapshot","prompt":"Check how much USDC the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 holds on Base using the USDC contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913."},{"title":"Gating access by token holdings","prompt":"Before letting this user in, verify that wallet 0xAbc123...def holds at least 100 tokens of contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — give me the raw and formatted balance."},{"title":"Automated on-chain balance alert","prompt":"Every hour, fetch the USDC balance of 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum using contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 and tell me if it drops below 50 USDC."}],"resultDescription":"A JSON object containing: the human-readable token balance as a decimal string (e.g. '12.5'), the raw integer balance (e.g. '12500000'), the token symbol (e.g. 'USDC'), and the number of decimals used by the contract (e.g. 6).","failureModes":["Invalid or non-checksummed EVM address returns an error or empty balance","Unsupported chain value (only 'base' and 'ethereum' accepted) causes a 400-level error","Non-ERC-20 contract address or wrong contract address returns zero or error","Payment failure via x402 (insufficient USDC or misconfigured wallet) results in 402 response","Network timeout or RPC node unavailability from the European hub may cause latency spikes or failures"],"whenToPreferThis":"Choose this endpoint when you need a quick, no-account, pay-per-call ERC-20 balance lookup on Base or Ethereum without setting up an API key or indexer. It is ideal for lightweight agents or automation scripts that need occasional on-chain balance reads billed directly in USDC via x402. Prefer alternatives (e.g. Alchemy, Infura, Moralis) if you need bulk queries, full token portfolio scans, historical balances, or very high throughput.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T12:44:33.751Z","isFirstParty":false,"canonicalSlug":"erc-20-token-balance-lookup-base-ethereum-50f8bc82"}