{"uid":"cap_G2SMp9uwnq74UmAT3o6Ck","slug":"solana-token-holder-concentration-analyzer-e4bd3733","name":"Solana Token Holder Concentration Analyzer","description":"Solana token cap-table: the top holders with amounts and percentages, where the bonding-curve account, AMM/DEX pool vaults and the incinerator are LABELLED and EXCLUDED so real concentration is measured over the free float. Returns top1/top5/top10 percent of circulating, an HHI concentration index and a low-float warning.","url":"https://api.agentstools.dev/sol/token/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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["mint"],"properties":{"mint":{"type":"string","maxLength":44,"minLength":32,"description":"Base58 Solana SPL token mint address (e.g. a pump.fun mint ending in 'pump'). The only required input; all upstream hosts are fixed server-side."},"launchpad":{"enum":["pumpfun"],"type":"string","description":"Launchpad whose bonding-curve layout to decode (default pumpfun; new launchpads are added as data)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LvKtdoPkl1SMZstvjWBIl","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns top holder concentration metrics (top1/5/10%), HHI index, and free-float cap table for a Solana SPL token, excluding bonding-curve, AMM pool vaults, and incinerator accounts.","exampleAgentPrompt":"Can you check the holder concentration for this pump.fun token — mint address 6xdT2nzgbPd9bBrWXwWHEMh5RnLkDvCXXXXXXXXpump — and tell me the top10 percentage, the HHI score, and whether there's a low-float warning?","exampleUseCases":[{"title":"Rug-risk check before buying memecoin","prompt":"Before I ape into this pump.fun token with mint address 8yKZ3nLpQwRtMnXXXXXXXXXXXXXXXXXXXXXpump, can you pull the holder concentration stats and tell me if the top 10 wallets control more than 30% of the free float and whether there's a low-float warning?"},{"title":"Token due diligence for DeFi research report","prompt":"I'm writing up a research note on a Solana SPL token — mint is DezXAZ8z7PnrnRJjz3wXboRgixCa6xjnB7YaB1pPB263. Can you get me the cap table breakdown excluding bonding curves and pool vaults, plus the HHI concentration index?"},{"title":"Automated whale-alert for token screening bot","prompt":"Run a holder concentration check on Solana mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v and flag it if the top 5 wallets hold more than 20% of circulating supply or if the HHI looks dangerously high."}],"resultDescription":"Returns a ranked list of the top token holders with their wallet addresses, token amounts, and percentage of circulating supply — with bonding-curve accounts, AMM/DEX pool vaults, and the incinerator address labeled and excluded so concentration is measured over true free float. Also returns aggregated top1/top5/top10 percentages, an HHI (Herfindahl–Hirschman Index) concentration score, and a boolean low-float warning flag.","failureModes":["Invalid or malformed mint address (non-base58, wrong length) — returns 400 with validation error","Token mint not found on-chain — returns 404 or empty holder list","Unsupported launchpad layout — bonding-curve exclusion may fail for non-pumpfun launchpads","RPC/upstream Solana node timeout — returns 503 or timeout error","Payment not attached or insufficient — returns 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need accurate free-float holder concentration for a Solana SPL token, especially pump.fun memecoins, and want bonding-curve accounts, AMM pool vaults, and the incinerator automatically excluded so whale concentration reflects real tradeable supply. Prefer it over raw RPC holder queries when you need ready-to-use HHI and top-N percentage metrics without post-processing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:45:37.383Z","isFirstParty":false,"canonicalSlug":"solana-token-holder-concentration-analyzer-e4bd3733"}