{"uid":"cap_SyuNcwmRqAUhU5qUXcRj7","slug":"erc-20-token-balance-lookup-base-ethereum-07488b17","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://ariogw.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_TwqTVbQl46F7ZRaCVHdnp","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 address is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.","exampleUseCases":[{"title":"DeFi portfolio balance check","prompt":"Tell me how much USDC wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 is holding on Base — use contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913."},{"title":"Payment gateway balance verification","prompt":"Before processing a payout, check whether address 0xAbCd1234... holds at least 50 USDC on Ethereum — the USDC contract is 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48."},{"title":"Airdrop eligibility token check","prompt":"I need to verify if wallet 0x1234abcd... has any of our governance token (contract 0xTokenAddr...) on Base before we include them in the airdrop list."}],"resultDescription":"A JSON object containing: 'balance' (human-readable formatted amount, e.g. '12.5'), 'raw' (raw integer string before decimal adjustment, e.g. '12500000'), 'symbol' (token ticker, e.g. 'USDC'), and 'decimals' (integer, e.g. 6). Useful for displaying balances or programmatic comparisons.","failureModes":["Invalid or malformed EVM address returns an error response","Unsupported chain value (anything other than 'base' or 'ethereum') causes a validation failure","Invalid ERC-20 contract address (non-existent or non-ERC20 contract) may return zero balance or error","Network/RPC issues from the Europe hub can cause timeouts","Payment failure via x402/USDC may block the request before execution"],"whenToPreferThis":"Choose this endpoint when you need a quick, no-account on-chain ERC-20 balance lookup on Base or Ethereum without setting up RPC infrastructure or an API key. Ideal for lightweight agent workflows that need pay-per-call pricing via USDC x402. Prefer alternatives (e.g. Alchemy, Infura, Moralis) for high-volume batch queries, multi-chain support beyond Base/Ethereum, or when historical balance data is needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T06:45:16.551Z","isFirstParty":false,"canonicalSlug":"erc-20-token-balance-lookup-base-ethereum-07488b17"}