{"uid":"cap_zKNX3yvNXxEe7Fk-SI9Qc","slug":"erc-20-token-balance-lookup-base-ethereum-f0a3ed63","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://superstone.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_wNvy1Nux6DhAeTNvoa0x9","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.","exampleAgentPrompt":"What's the current USDC balance for wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base — use contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?","exampleUseCases":[{"title":"Portfolio balance snapshot","prompt":"Check how much USDC wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 holds on Base using token contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913."},{"title":"Pre-payment eligibility check","prompt":"Before we proceed, verify whether address 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B has at least 50 USDC on Ethereum — use the USDC contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48."},{"title":"DeFi agent treasury monitoring","prompt":"How many tokens does our DAO treasury wallet 0x1234567890abcdef1234567890abcdef12345678 currently hold for ERC-20 contract 0x6B175474E89094C44Da98b954EedeAC495271d0F on Ethereum?"}],"resultDescription":"Returns a JSON object with the wallet's token balance formatted for human reading (e.g. '12.5'), the raw integer balance, the token symbol (e.g. 'USDC'), and the number of decimals used by the token contract.","failureModes":["Invalid or malformed EVM address returns an error","Unsupported chain value (only 'base' or 'ethereum' accepted)","Invalid ERC-20 contract address returns an error or zero balance","Network/RPC timeout causes delayed or failed response","Payment failure via x402 prevents request from being processed"],"whenToPreferThis":"Choose this endpoint when you need a quick, no-account ERC-20 token balance lookup on Base or Ethereum and want to pay per-call in USDC via x402 without setting up API credentials. Ideal for agents that need on-demand, low-frequency balance checks without committing to a subscription or API key.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T06:36:28.529Z","isFirstParty":false,"canonicalSlug":"erc-20-token-balance-lookup-base-ethereum-f0a3ed63"}