{"uid":"cap_h2NvCy9EwL7bHu0rMntba","slug":"public-zapper-xyz-1907f0a2","name":"Zapper Token Balances","description":"Fetch detailed token balances for a single address or list of addresses, optionally filtered by chain, with pagination (max 20 tokens).","url":"https://public.zapper.xyz/x402/token-balances","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"first":{"type":"integer","default":10,"description":"Number of tokens to return (max 20)"},"chainIds":{"type":"array","items":{"type":"integer"},"description":"Optional list of Chain IDs to filter by (e.g. [1, 8453])"},"addresses":{"type":"array","items":{"type":"string","description":"A 0x wallet address"},"description":"Array of 0x wallet addresses to aggregate"}}},"responseSchema":null,"example":{"request":{"first":10,"chainIds":[1],"addresses":["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"]},"response":{"_nonJson":true,"_preview":"{\"data\":{\"portfolioV2\":{\"tokenBalances\":{\"totalBalanceUSD\":1185403.1196175863,\"byToken\":{\"totalCount\":1000,\"edges\":[{\"node\":{\"name\":\"WhiteRock\",\"symbol\":\"WHITE\",\"price\":0.00007611585399676583,\"tokenAddress\":\"0x9cdf242ef7975d8c68d5c1f5b6905801699b1940\",\"imgUrlV2\":\"https://storage.googleapis.com/zapper-fi-assets/tokens/ethereum/0x9cdf242ef7975d8c68d5c1f5b6905801699b1940.png\",\"decimals\":18,\"balanceRaw\":\"10000000000000000000000000000\",\"balance\":10000000000,\"balanceUSD\":237123.60325869086,\"network\":{","_contentType":"application/octet-stream"}},"exampleRequest":{"first":10,"chainIds":[1],"addresses":["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"]},"tags":["x402"],"displayCostAmount":"0.001125","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001125/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001125","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001125","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_aTUT4v95GXAEFZZIzbfYA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001125","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches detailed token balances (with USD values, prices, and metadata) for one or more wallet addresses, optionally filtered by chain.","exampleAgentPrompt":"Show me the top 10 token balances for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum mainnet (chain ID 1) using Zapper — include USD values and token prices.","exampleUseCases":null,"resultDescription":"Returns a paginated list of up to 20 tokens held by the queried address(es), including token name, symbol, price, raw balance, USD balance, contract address, image URL, and network. Also includes a totalBalanceUSD aggregated across all returned tokens.","failureModes":["Invalid wallet address format returns an error or empty result","Chain ID not supported returns empty token list","Requesting more than 20 tokens per page is capped at 20","No tokens found for the address on the specified chain returns empty edges array","Network or upstream Zapper API errors may return non-JSON or partial responses"],"whenToPreferThis":"Use this endpoint when you need granular per-token breakdown of a wallet's holdings including USD valuation, token metadata, and multi-chain filtering. Prefer this over the portfolio totals endpoint when you need individual token-level detail rather than aggregate network summaries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T09:26:24.076Z","isFirstParty":false}