{"uid":"cap_aLmwVIuybm13CW3Eus8V6","slug":"erc-20-token-balance-lookup-by-wallet-84ad8bd6","name":"ERC-20 Token Balance Lookup by Wallet","description":"Any wallet's balance of any ERC-20 token (USDC, USDT, DAI, or any contract) via balanceOf, across Base, Ethereum, Optimism, Arbitrum, Polygon, Gnosis. The token-balance read wallet-tracking, copy-trade, treasury and trading agents poll constantly — the most-called RPC read after native balance. Live public RPC; undercuts onesource at $0.001.","url":"https://x402-agent-store.rileycraig14.workers.dev/chain/erc20-balance","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":["wallet","token"],"properties":{"chain":{"type":"string","description":"base|ethereum|optimism|arbitrum|polygon|gnosis (default base)"},"token":{"type":"string","description":"ERC-20 token contract address (0x...)"},"wallet":{"type":"string","description":"Holder wallet address (0x...)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"balance":{"type":"number"},"decimals":{"type":"number"},"raw_balance":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"chain":"base","token":"0x...","wallet":"0x...","balance":1250.5,"decimals":6,"raw_balance":"1250500000"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gC4Ry--HEC1KxlL3l8FO5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","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 a specified EVM-compatible chain, paying per call via x402/USDC with no API key required.","exampleAgentPrompt":"What's the USDC balance (contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum?","exampleUseCases":null,"resultDescription":"A JSON object containing the wallet address, token contract address, chain name, human-readable balance (float), token decimals (integer), and raw balance string (unscaled integer before decimal adjustment).","failureModes":["Invalid or malformed wallet address returns an error response","Invalid or non-ERC-20 token contract address returns an error","Unsupported chain name returns an error (supported: base, ethereum, optimism, arbitrum, polygon, gnosis)","Missing required query parameters (wallet or token) returns a validation error","Payment failure or insufficient USDC for x402 fee returns HTTP 402","RPC node unavailability may cause intermittent timeouts"],"whenToPreferThis":"Use this endpoint when an AI agent needs to read the on-chain ERC-20 token balance of any wallet across major EVM chains without setting up API keys or accounts. It is ideal for DeFi automation, portfolio checks, or any workflow requiring permissionless, pay-per-call on-chain data access via x402 micro-payments in USDC.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:47:48.731Z","isFirstParty":false}