{"uid":"cap_7eOp7sJ-3mV2GXPfKMO-u","slug":"erc-20-token-balance-lookup-base-polygon-arbitrum-optimism-2e4bccd3","name":"ERC-20 Token Balance Lookup (Base/Polygon/Arbitrum/Optimism)","description":"Pay-per-call endpoints for AI agents: web search, web-to-markdown reader, LLM chat completions, encrypted secret storage with one-read dead drops, and a business-idea generator. Payment over x402: USDC on Base, or XNO on nano:mainnet.","url":"https://pyfile-agent.taile3ff35.ts.net/data/chain/erc20-balance?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"ok":true}},"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_eGlpTjshfPBT-MpfxVCuv","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 of a wallet address on Base, Polygon, Arbitrum, or Optimism — in both raw base units and human-readable form when decimals are provided.","exampleAgentPrompt":"Can you check the USDC balance (token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48) for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base? USDC has 6 decimals so I want the human-readable amount too.","exampleUseCases":[{"title":"DeFi portfolio balance check","prompt":"What's the USDC balance on Polygon for my wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045? The USDC contract on Polygon is 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 and it has 6 decimals — give me the human-readable amount."},{"title":"Agent treasury verification before payment","prompt":"Before I trigger a payout, check whether the treasury wallet 0xAbCd1234567890AbCd1234567890AbCd12345678 holds at least 500 USDT on Arbitrum — the USDT contract there is 0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9 with 6 decimals."},{"title":"Monitor airdrop token receipt","prompt":"Has the airdrop token at contract 0x1234567890abcdef1234567890abcdef12345678 landed in wallet 0x9876543210abcdef9876543210abcdef98765432 on Optimism yet? It has 18 decimals so show me the full human-readable balance."}],"resultDescription":"A JSON response containing the raw balance in base units (as returned by the ERC-20 balanceOf call) and, when the decimals parameter is supplied, a human-readable balance adjusted for decimal precision. Includes chain, token contract address, and owner address for confirmation.","failureModes":["Invalid or non-checksummed contract/wallet address returns an error","Unsupported chain name returns an error (only base, polygon, arbitrum, optimism accepted)","Token contract address that is not ERC-20 compliant may return zero or an RPC error","Missing required query params (chain, token, address) returns a 400-level error","Payment not completed or insufficient USDC balance returns 402 Payment Required","RPC node timeouts or chain congestion may cause temporary failures"],"whenToPreferThis":"Use this endpoint when you need a quick, pay-per-call ERC-20 balance lookup on Base, Polygon, Arbitrum, or Optimism without running your own node or managing RPC infrastructure. It is ideal for AI agents that need to verify wallet holdings before authorizing payments, check DeFi positions, or confirm airdrop receipt. Prefer it over full blockchain indexers when you only need a single address+token balance snapshot on supported L2/sidechain networks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T19:11:47.038Z","isFirstParty":false,"canonicalSlug":"erc-20-token-balance-lookup-base-polygon-arbitrum-optimism-2e4bccd3"}