{"uid":"cap_GacGtYGMlDI5iCSaPDhVP","slug":"sol-token-holders-f4954648","name":"sol-token-holders","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://payai.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":{"p10Cents":"2.0000","medianCents":"2.0000","p90Cents":"2.0000","minCents":"2.0000","maxCents":"2.0000","p95Cents":"2.0000","sampleCount":1,"varies":false,"failureChargeRate":1},"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_hDNiZFa-7Ot8T2DFsyO0P","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 the Solana SPL token cap table with top holder concentration metrics (top1/top5/top10% of free float), HHI index, and low-float warning after excluding bonding-curve, AMM/DEX pool vaults, and incinerator accounts.","exampleAgentPrompt":"Can you check the real holder concentration for this pump.fun token — mint address 6xkFMQBJZNpCXp9fBqXBKQmK8j3iT2rPo7cBsXNvpump — and tell me the top 10 holder percentage, HHI index, and whether there's a low-float warning? Make sure to exclude the bonding-curve and DEX pool accounts.","exampleUseCases":null,"resultDescription":"A ranked list of real token holders with their amounts and percentage of free-float circulating supply, with bonding-curve accounts, AMM/DEX vault addresses, and the incinerator labeled and excluded. Includes top1, top5, and top10 concentration percentages, an HHI (Herfindahl-Hirschman Index) score indicating how concentrated ownership is, and a boolean low-float warning flag.","failureModes":["Invalid or malformed mint address returns a 400 error","Mint address not found on-chain returns empty or null holder data","Rate limiting or upstream RPC unavailability returns a 5xx error","Payment not settled via x402 protocol returns 402 Payment Required","Unknown launchpad type passed to launchpad param returns an error or falls back to default"],"whenToPreferThis":"Use this endpoint when you need free-float-accurate holder concentration for a Solana SPL token, especially pump.fun mints, and want bonding-curve, DEX vault, and incinerator accounts automatically excluded so concentration metrics reflect real human wallets. Prefer this over generic holder APIs when you need HHI scoring and low-float warnings in a single call without manual filtering.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T12:45:18.307Z","isFirstParty":false,"canonicalSlug":"sol-token-holders-f4954648"}