{"uid":"cap_6DAVIXKhrWGZHgR76Wi_C","slug":"erc-20-token-balance-lookup-base-ethereum-4a1d5701","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://rubycom.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_uwpglKqApnAeC10QlOl6Q","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 is the USDC balance for wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base — use contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?","exampleUseCases":[{"title":"DeFi portfolio balance check","prompt":"Check how much USDC is currently held by wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base using contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913."},{"title":"Agent treasury monitoring","prompt":"Look up the current token balance for our treasury wallet 0xAbCd1234...5678 on Ethereum for the DAI contract 0x6B175474E89094C44Da98b954EedeAC495271d0F — I need the human-readable amount."},{"title":"Verify on-chain payment receipt","prompt":"Can you confirm that wallet 0x1234...abcd received at least 50 USDC on Base by checking its balance against contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?"}],"resultDescription":"Returns a JSON object with four fields: 'balance' (human-readable decimal string, e.g. '12.5'), 'raw' (integer string of the smallest unit), 'symbol' (token ticker, e.g. 'USDC'), and 'decimals' (integer, e.g. 6). Useful for displaying or comparing token holdings without manual decimal conversion.","failureModes":["Invalid or malformed EVM address returns an error response","Unsupported chain value (not 'base' or 'ethereum') causes a validation failure","Invalid ERC-20 contract address returns an error or zero balance","Network timeout or RPC node unavailability from the Germany hub may cause transient failures","Missing required query parameters (chain, token, address) results in a schema validation error"],"whenToPreferThis":"Choose this endpoint when you need a quick, account-free ERC-20 balance lookup on Base or Ethereum and are comfortable paying $0.002 USDC per call via x402. It is ideal for agents that need on-chain token data without managing API keys or rate limits, and when geographic latency from Europe is acceptable. Prefer alternatives if you need multi-chain support beyond Base/Ethereum, sub-millisecond latency, or bulk batch queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T12:56:20.390Z","isFirstParty":false,"canonicalSlug":"erc-20-token-balance-lookup-base-ethereum-4a1d5701"}