{"uid":"cap_c1tOg_93W-kp0d4i7ZfIx","slug":"sleuth-ai-holder-distribution-90757740","name":"Sleuth AI Holder Distribution","description":"Pay-per-call on-chain investigation API (x402, USDC on Base).","url":"https://x402.sleuthagent.ai/api/v1/holder-distribution","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"enum":["auto","base","ethereum","arbitrum","polygon","bsc","robinhood","solana","bnb","robinhoodchain"],"type":"string","default":"auto"},"token":{"type":"string","maxLength":200,"minLength":1},"conversation_id":{"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{"nodes":[{"id":"base_sleuth:obs0","rows":[["0x1111111111111111111111111111111111111111","12,400,000","41.2%"],["0x2222222222222222222222222222222222222222","6,900,000","22.9%"]],"tool":"data_miner","title":"Top holders","columns":["wallet","balance","pct_supply"],"summary":"Largest current holders by balance.","row_count":2,"truncated":false}]},"response":"The top 10 wallets hold 64% of supply; the distribution is whale-heavy…","request_id":"req_9f8e7d6c5b4a"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.099","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.099/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.099","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.099","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_skshda2RI58Ge2TOLjmsd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.099","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a ranked breakdown of the largest token holders for an on-chain asset, including wallet addresses, balances, and percentage of total supply.","exampleAgentPrompt":"Can you pull the holder distribution for the token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Base and tell me if the supply is whale-heavy or reasonably spread out?","exampleUseCases":[{"title":"Whale concentration check before investing","prompt":"Before I buy into this token, can you check who the top holders are for 0xd9aAEc86B65D86f6A7B5B1b0c42FFA531710b6CA on Base and tell me if a few wallets control most of the supply?"},{"title":"DeFi protocol token risk assessment","prompt":"I'm evaluating a DeFi project and need to know how concentrated the governance token supply is — can you pull the top holder breakdown for 0x4200000000000000000000000000000000000006 on Base?"},{"title":"Token launch fairness audit","prompt":"A new token just launched and I want to know if it's fairly distributed or if the team is sitting on most of it — can you show me the top wallet holders and their percentages for contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base?"}],"resultDescription":"Returns a ranked list of the top token holders with their wallet addresses, raw balances, and percentage of total supply, along with a natural language summary describing whether the distribution is whale-heavy or dispersed. Results include metadata like row count and whether the result set was truncated.","failureModes":["Invalid or unrecognized contract address returns an error or empty result","Contract exists on a different chain than expected, causing no data","Token has insufficient on-chain data or indexing lag, returning incomplete results","Payment failure via x402/USDC results in 402 Payment Required response","Rate limiting or node timeout may cause delayed or failed responses"],"whenToPreferThis":"Use this endpoint when you need structured, ranked on-chain holder data for a specific token contract, especially when you want both raw wallet-level data and a summarized concentration assessment. Prefer this over generic blockchain explorers when you need the data in a machine-readable format suitable for agent workflows, or when you want AI-narrated analysis alongside the raw numbers.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:32:39.816Z","isFirstParty":false}