{"uid":"cap_pemWsuovRobfTupzou7Iu","slug":"public-zapper-xyz-1813e8d7","name":"Zapper Token Holders Lookup","description":"Enterprise grade onchain data across 60+ chains - token prices, NFTs, portfolios, onchain search, Farcaster and more.","url":"https://public.zapper.xyz/x402/token-holders","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"after":{"type":"string","description":"Cursor for pagination"},"first":{"type":"number","description":"Number of holders to return"},"address":{"type":"string","description":"Token contract address (0x...)"},"chainId":{"type":"integer","description":"Chain ID of the network (e.g. 1 for Ethereum, 8453 for Base)"}}},"responseSchema":null,"example":null,"exampleRequest":null,"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_9T0DKgsxpKm61oRlzt3Js","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":"Returns a paginated list of holders for a given ERC20 token contract on a specified blockchain network","exampleAgentPrompt":"Who are the top 20 holders of the token at contract address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base (chain ID 8453)?","exampleUseCases":null,"resultDescription":"A paginated list of wallet addresses that hold the specified ERC20 token on the given chain, up to the requested number of holders. The response is returned as content (likely CSV or JSON) with a content-type header and a preview string.","failureModes":["Invalid or non-existent contract address returns empty or error response","Unsupported chainId returns an error","Requesting more holders than available may return a partial list","Malformed address format (not 0x-prefixed) causes validation error","Network timeout if the chain is congested or data is unavailable"],"whenToPreferThis":"Use this endpoint when you need to identify wallet addresses holding a specific ERC20 token on a supported EVM chain, especially for on-chain analytics, airdrop targeting, governance analysis, or holder distribution research. Prefer this over generic blockchain explorers when you want structured, API-ready holder data with pagination support via Zapper's indexed data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T10:25:18.037Z","isFirstParty":false}