{"uid":"cap_4yx20GRXuJpouEBNkh4w0","slug":"agent-data-bench-token-top-holders-43405aa6","name":"Agent Data Bench – Token Top Holders","description":"Top token holders with wallet, balance, percent of supply, labels/tags and first-seen time. Percent of supply is computed for you from total supply, so the result is ready for concentration checks, whale tracking or airdrop analysis. Works for Solana SPL and ERC-20 tokens on Base and Ethereum.","url":"https://x402.deepsense.stream/api/v1/market/holders?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":["chain","token"],"properties":{"chain":{"enum":["sol","eth","base"],"type":"string","description":"Chain id: sol (Solana), eth (Ethereum), base (Base)"},"limit":{"type":"integer","default":50,"maximum":100,"minimum":1},"token":{"type":"string","description":"Token contract / mint address"},"orderBy":{"enum":["amount","createdAt"],"type":"string","default":"amount"},"direction":{"enum":["asc","desc"],"type":"string","default":"desc"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_ReFDdGM_8UZ0kHzg5R4cq","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 the top token holders for a Solana SPL or EVM ERC-20 token, including wallet address, balance, percent of supply, labels/tags, and first-seen timestamp.","exampleAgentPrompt":"Who are the top 50 holders of the Solana token at mint address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v? Show me their balances, percent of supply, and any labels — I want to check for whale concentration.","exampleUseCases":[{"title":"Whale concentration check before investing","prompt":"Pull the top 100 holders of Ethereum token 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 and tell me what percentage of the supply the top 10 wallets control — I want to know if this token is dangerously concentrated."},{"title":"Airdrop eligibility list for Solana token","prompt":"Give me the top 200 holders of the Solana SPL token at mint address So11111111111111111111111111111111111111112, sorted by balance descending, so I can build an airdrop snapshot."},{"title":"Early holder discovery for Base token","prompt":"Find the earliest holders of Base token 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — sort by first-seen time ascending and show me the top 50 so I can see who got in first."}],"resultDescription":"A ranked list of top token holders, each containing the wallet address, raw token balance, percent of total supply, any known labels or tags (e.g. exchange, whale, team), and the timestamp when the wallet was first seen holding the token. Results are pre-computed for concentration checks, whale tracking, and airdrop analysis.","failureModes":["Invalid or unsupported token contract address returns an error or empty list","Chain mismatch — passing an EVM address with chain=sol or vice versa","Limit exceeds maximum of 100 — returns validation error","Token with very low on-chain activity may return fewer holders than requested","Network timeouts for tokens with very large holder sets","Unknown or unresolvable mint address returns 404 or empty response"],"whenToPreferThis":"Use this endpoint when you need ready-to-use holder concentration data with percent-of-supply already computed, across Solana SPL tokens and ERC-20s on Ethereum and Base. Prefer it over raw blockchain RPC calls when you need labeled/tagged wallets and first-seen timestamps in a single call without manual post-processing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:41:55.416Z","isFirstParty":false,"canonicalSlug":"agent-data-bench-token-top-holders-43405aa6"}