{"uid":"cap_omHEOakZOErkj4L4fFuFS","slug":"evm-multi-chain-token-balance-lookup-236a251e","name":"EVM Multi-Chain Token Balance Lookup","description":"Generate an AI_POLICY.md and a pull request template with an AI-disclosure section for your open-source repo. Free, runs in your browser.","url":"https://ai-policy-kit.moneymaker-ai.workers.dev/api/token-balances?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"],"properties":{"chain":{"type":"string","description":"optional; one or more of base, ethereum, bsc, arbitrum, optimism, polygon, gnosis, celo (comma-separated). Default: base, ethereum, arbitrum, optimism, polygon, bsc"},"tokens":{"type":"string","description":"optional; up to 20 comma-separated token addresses (needs a single chain=)"},"address":{"type":"string","description":"0x EVM address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chains":[{"rpc":"mainnet.base.org","block":52932309,"chain":"base","native":{"symbol":"ETH","balance":"0.000412069025068897","balance_raw":"412069025068897"},"tokens":[{"token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","balance":"1.125","read_ok":true,"decimals":6,"balance_raw":"1125000"},{"token":"0xfde4C96c8593536E31F229EA8f37b2ADa2699bb2","symbol":"USDT","balance":"0","read_ok":true,"decimals":6,"balance_raw":"0"},{"token":"0x4200000000000000000000000000000000000006","symbol":"WETH","balance":"0","read_ok":true,"decimals":18,"balance_raw":"0"},{"token":"0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf","symbol":"cbBTC","balance":"0","read_ok":true,"decimals":8,"balance_raw":"0"},{"token":"0x50c5725949A6F0c72E6C4a641F24049A917DB0Cb","symbol":"DAI","balance":"0","read_ok":true,"decimals":18,"balance_raw":"0"},{"token":"0x60a3E35Cc302bFA44Cb288Bc5a4F316Fdb1adb42","symbol":"EURC","balance":"0","read_ok":true,"decimals":6,"balance_raw":"0"}],"chainId":8453}],"address":"0x5b4Ca59741DE12DC212982b342392a063492a021","nonzero":[{"chain":"base","native":true,"symbol":"ETH","balance":"0.000412069025068897"},{"chain":"base","token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","symbol":"USDC","balance":"1.125"}],"unreachable":[]}},"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_ZJMz_QRlbHyCMf__hGbYc","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 native and ERC-20 token balances for an EVM wallet address across multiple blockchain networks","exampleAgentPrompt":"What are the current ETH and USDC token balances for wallet 0x5b4Ca59741DE12DC212982b342392a063492a021 on Base and Ethereum?","exampleUseCases":[{"title":"DeFi portfolio snapshot for a wallet","prompt":"Can you pull all the token balances for 0xAbC123...def on Base, Ethereum, and Arbitrum so I can see my full DeFi portfolio at a glance?"},{"title":"Check USDC balance before on-chain payment","prompt":"Before I send a payment, can you verify how much USDC is sitting in wallet 0x5b4Ca59741DE12DC212982b342392a063492a021 on Base right now?"},{"title":"Monitor airdrop landing in wallet","prompt":"I'm expecting an airdrop of token 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — can you check if it's shown up in my wallet 0xABCDE...12345 yet?"}],"resultDescription":"Returns a structured JSON object with per-chain breakdowns including the current block number, native token balance (e.g. ETH), and balances for specified or default ERC-20 tokens (USDC, USDT, WETH, cbBTC, DAI, EURC). Also includes a 'nonzero' summary array listing only tokens with positive balances, and an 'unreachable' array for any chains that couldn't be queried.","failureModes":["Invalid or malformed 0x wallet address returns an error or empty result","Unsupported chain name causes that chain to appear in the 'unreachable' list","More than 20 token addresses specified with tokens param causes request rejection","Specifying 'tokens' param without a single 'chain' param is unsupported","RPC node downtime may result in a chain appearing in 'unreachable'","Payment failure (x402) blocks request before execution"],"whenToPreferThis":"Use this endpoint when you need a fast, multi-chain token balance snapshot for any EVM-compatible wallet address without standing up your own RPC infrastructure. It is particularly useful for agents that need to check wallet liquidity before initiating payments, build portfolio views, or verify airdrop/transfer receipt across Base, Ethereum, Arbitrum, Optimism, Polygon, BSC, Gnosis, and Celo in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:37:33.041Z","isFirstParty":false,"canonicalSlug":"evm-multi-chain-token-balance-lookup-236a251e"}