{"uid":"cap_puKIokfkQRniFlYo97AEJ","slug":"zapper-token-balances-by-address-c33829cf","name":"Zapper Token Balances by Address","description":"Token balances of an EVM wallet across chains from Blockscout explorers: native coin and ERC-20 holdings with amount, USD price and USD value (largest first), plus per-chain and overall USD totals. Ethereum, Optimism and Gnosis by default; Base, Arbitrum and Polygon when the operator's free Blockscout key is set. Prices are Blockscout's; airdropped tokens can be spam.","url":"https://api.chainmarket-api.workers.dev/api/crypto/zapper-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":{"limit":{"type":"string","description":"Tokens per chain, 1 to 50 (default 20)"},"chains":{"type":"string","description":"Comma list from ethereum, optimism, gnosis, base, arbitrum, polygon (default: every chain available)"},"address":{"type":"string","description":"EVM wallet address (0x + 40 hex characters)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chains":[{"chain":"optimism","native":{"amount":0.18107959,"symbol":"ETH","priceUsd":2393.91,"valueUsd":433.49},"tokens":[{"name":"L2 Standard Bridged WETH (Optimism)","amount":0.03493032,"symbol":"WETH","contract":"0x4200000000000000000000000000000000000006","priceUsd":2408.12,"valueUsd":84.12,"reputation":"ok"},{"name":"Bridged USDT","amount":43.384903,"symbol":"USDT","contract":"0x94b008aA00579c1307B0EF2c499aD98a8ce58e58","priceUsd":0.998925,"valueUsd":43.34,"reputation":"ok"}],"chainId":10,"totalUsd":666.55,"moreTokens":true,"tokensShown":10}],"source":"Blockscout explorers (blockscout.com)","address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","totalUsd":666.55,"checkedAt":"2026-10-23T09:36:05.662Z","unavailableChains":[{"chain":"ethereum","error":"Blockscout (ethereum) timed out"}]}},"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_M-T8ii3OpwJhCHyboG_BQ","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 EVM wallet token balances (native + ERC-20) with USD values across multiple chains using Blockscout explorer data","exampleAgentPrompt":"Look up all token balances for the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 across Ethereum, Base, and Optimism — show me each token's amount and USD value, and give me the total portfolio value.","exampleUseCases":[{"title":"Portfolio snapshot before a trade","prompt":"Before I move funds, can you check what tokens wallet 0xAb5801a7D398351b8bE11C439e05C5B3259aec9B holds on Ethereum and Arbitrum, with their current USD values?"},{"title":"DeFi holdings audit for a DAO treasury","prompt":"Pull the full token breakdown for the DAO treasury at 0x4F868C1aa37fCf307ab38D215382e88FCA6275E2 across all available chains — I need each token name, amount, price, and total USD value."},{"title":"Monitor a whale wallet's balances","prompt":"Check what tokens the wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 is holding on Base and Polygon right now, showing up to 50 tokens per chain."}],"resultDescription":"Returns a JSON object with per-chain breakdowns including native asset (symbol, amount, USD value) and a list of ERC-20 tokens (name, symbol, contract address, amount, USD price, USD value, reputation), plus a grand total USD value, a timestamp, and any chains that were unavailable due to errors or timeouts.","failureModes":["Invalid or malformed wallet address returns an error (address must be 0x + 40 hex chars)","Chain provider timeout results in that chain appearing in unavailableChains with an error message","Unsupported chain name in the chains parameter causes a validation error","Address with no token balances returns empty token arrays","Rate or payment failure results in no charge but no data returned"],"whenToPreferThis":"Choose this endpoint when you need a multi-chain EVM token balance snapshot with USD pricing for any public wallet address, without requiring an API key or signup. It aggregates across Ethereum, Optimism, Base, Arbitrum, Polygon, Gnosis and more in a single call, making it ideal for portfolio checks, treasury audits, or whale-wallet monitoring where you need both native and ERC-20 token data with live USD values.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-24T12:36:31.215Z","isFirstParty":false,"canonicalSlug":"zapper-token-balances-by-address-c33829cf"}