{"uid":"cap_DnhD-lIJgctkQuZNm_5D9","slug":"erc-20-token-balance-lookup-on-chain-ddf6fad3","name":"ERC-20 Token Balance Lookup (On-Chain)","description":"Pay-per-call website uptime/latency/TLS checks and fetch-to-Markdown, measured from US Central (St. Louis). USDC on Base via x402. No account or API key.","url":"https://rockndefi.xyz: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_85uZQVAaD5GohyO2Xdbms","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, including raw amount, formatted balance, symbol, and decimals.","exampleAgentPrompt":"What's the USDC balance of wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base? The USDC contract is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.","exampleUseCases":[{"title":"Verify wallet funding before a DeFi action","prompt":"Before we execute the swap, check whether 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 has enough USDC on Base — the contract address is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913."},{"title":"Portfolio token balance snapshot","prompt":"Pull the current USDC balance on Ethereum for wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B using the USDC contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 so I can update our portfolio tracker."},{"title":"Airdrop eligibility check","prompt":"Check whether the address 0x1234567890abcdef1234567890abcdef12345678 holds any of the token at contract 0xTokenContractAddressHere on Base — I need the exact balance before deciding if they qualify for the airdrop."}],"resultDescription":"Returns a JSON object with four fields: 'balance' (human-readable formatted amount, e.g. '12.5'), 'raw' (unformatted big integer string, e.g. '12500000'), 'symbol' (token ticker, e.g. 'USDC'), and 'decimals' (integer precision, e.g. 6). Payment is $0.002 USDC per call via x402 on Base, no account required.","failureModes":["Invalid or non-checksummed EVM address returns an error or empty result","Non-existent ERC-20 contract address may return zero balance or an error","Unsupported chain value (only 'base' and 'ethereum' are accepted)","Network latency or RPC node unavailability may cause timeouts","Payment failure via x402 prevents the call from being processed"],"whenToPreferThis":"Choose this endpoint when you need a lightweight, no-account ERC-20 balance check on Base or Ethereum and want to pay per-call with USDC via x402 rather than provisioning an API key or running your own node. It is ideal for agents or scripts that need occasional on-chain balance queries without a persistent service subscription.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T12:39:13.364Z","isFirstParty":false,"canonicalSlug":"erc-20-token-balance-lookup-on-chain-ddf6fad3"}