{"uid":"cap_PdnoEOBjP5zzNtSv0pcQ1","slug":"erc20-token-balance-checker-base-ethereum-arbitrum-optimism-polygon-eeb1fcc3","name":"ERC20 Token Balance Checker (Base/Ethereum/Arbitrum/Optimism/Polygon)","description":"ERC20 token balance for any wallet on Base/Ethereum/Arbitrum/Optimism/Polygon via balanceOf (eth_call). Returns raw + decimal-formatted balance, symbol, decimals, block. Example: {address:\"0xd8dA…6045\", token:\"0x8335…2913\", chain:\"base\"}. $0.001.","url":"https://api.axiomworks.co.uk/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":["address","token"],"properties":{"chain":{"enum":["base","ethereum","arbitrum","optimism","polygon"],"type":"string","description":"EVM chain (default base)"},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC20 contract"},"wallet":{"type":"string","description":"Alias for address (owner wallet)"},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"Wallet address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"block":{"type":"number"},"symbol":{"type":"string"},"balance":{"type":"string"},"decimals":{"type":"number"},"balance_raw":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"block":53552081,"chain":"base","token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","source":"eth_call balanceOf","symbol":"USDC","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","balance":"81.809468","chain_id":8453,"decimals":6,"balance_raw":"81809468"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OkfIRtOLR-YzUK3jsWC1T","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the ERC20 token balance for a wallet address on Base, Ethereum, Arbitrum, Optimism, or Polygon — including raw amount, decimal-formatted balance, symbol, decimals, and block number.","exampleAgentPrompt":"What's the USDC balance for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base — give me both the formatted amount and the raw value?","exampleUseCases":[{"title":"DeFi portfolio balance check","prompt":"Can you check how much USDC the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 is holding on Base right now, including the raw balance?"},{"title":"Arbitrage bot pre-trade balance verification","prompt":"Before executing a trade, check the USDT balance on Arbitrum for wallet 0xAbCd1234567890abcdef1234567890abcdef1234 against token contract 0x8335... so we know if there are enough funds."},{"title":"Multi-chain token audit","prompt":"Look up the MATIC token balance for address 0x1234567890abcdef1234567890abcdef12345678 on Polygon — I need the token symbol, decimals, and both the raw and formatted balance."}],"resultDescription":"A JSON object containing: formatted decimal balance (e.g. '81.809468'), raw integer balance string (e.g. '81809468'), token symbol (e.g. 'USDC'), decimals (e.g. 6), block number at which the balance was read, chain name, chain ID, wallet address, and token contract address.","failureModes":["Invalid wallet or token address format (must match ^0x[0-9a-fA-F]{40}$) → likely 400 error","Unsupported chain name → rejected by enum validation","Token contract address is not a valid ERC20 contract → may return zero or error","RPC node unavailable for the target chain → upstream timeout or 5xx","Wallet has no balance for that token → returns '0' (not an error)"],"whenToPreferThis":"Use this endpoint when you need a quick, cheap ($0.001) on-chain ERC20 balance lookup across the five major EVM chains (Base, Ethereum, Arbitrum, Optimism, Polygon) with both raw and decimal-formatted output in a single call. It is ideal for DeFi agents, portfolio trackers, and pre-trade checks. Prefer this over manually calling an RPC node when you want symbol and decimals returned alongside the balance without additional contract calls.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T12:34:36.644Z","isFirstParty":false,"canonicalSlug":"erc20-token-balance-checker-base-ethereum-arbitrum-optimism-polygon-eeb1fcc3"}