{"uid":"cap_rOy4G6W3-NG9QEVnC7EIN","slug":"agent402-solana-token-holders-4697161c","name":"Agent402 Solana Token Holders","description":"Top-holder concentration for a Solana token mint: the 20 largest holders with token account, owner wallet, balance, percent of supply, insider flag and a pool/locker label when the account is a known AMM vault or locker, plus top-1/5/10/20 share, top-10 share excluding labelled pool accounts, insider count, total holder count and supply. Use it to tell a whale-held launch from one whose largest holder is the liquidity pool.","url":"https://agent402.tools/api/sol-token-holders","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"mint":{"type":"string","description":"Base58 SPL token mint address."},"limit":{"type":"number","description":"Holders to return (1-20, default 20)."}}},"responseSchema":{"type":"json","example":{"mint":"JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN","source":"rugcheck","supply":6862431164.93,"symbol":"JUP","holders":[{"pct":24.77,"label":null,"owner":"EXJH...","insider":false,"uiAmount":1700000000.1,"tokenAccount":"6G4X..."}],"decimals":6,"fetchedAt":"2026-08-22T12:00:00.000Z","totalHolders":2873512,"concentration":{"top1Pct":24.77,"top5Pct":57.67,"top10Pct":66.1,"top20Pct":75.2,"insiderHolders":0,"top10PctExcludingPools":66.1,"labeledPoolOrLockerAccounts":0}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_5RGexuNM6eQEzdcVg3Pj-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the top holders, concentration metrics, and supply details for any SPL token on Solana given its mint address.","exampleAgentPrompt":"Who are the top 10 holders of the JUP token on Solana (mint address JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN), and what percentage of supply do they control?","exampleUseCases":[{"title":"Rug-pull risk screening for new token","prompt":"I'm looking at a new Solana token with mint 7dHbWXmci3dT8UFYWYZweBLXgycu7Y3iL6trKn1Y7ARj — can you pull the top 20 holders and tell me the top-10 concentration percentage and whether any insiders are holding?"},{"title":"DeFi portfolio whale exposure check","prompt":"I hold a bunch of BONK tokens and I'm worried about whale dumps — fetch the top 5 holders of BONK (DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263) and their combined percentage of supply."},{"title":"Token listing due diligence report","prompt":"We're considering listing a new SPL token with mint address mSoLzYCxHdYgdzU16g5QSh3i5K3z3KZK7ytfqcJm7So on our platform — give me the holder distribution including top-1, top-5, and top-10 concentration percentages and the total number of unique holders."}],"resultDescription":"Returns a JSON object containing the token symbol, total supply, decimals, total holder count, a list of up to 20 top holders (each with wallet address, token account, UI amount, percentage of supply, label if known, and insider flag), concentration statistics (top 1/5/10/20 percentages, insider holder count, labeled pool/locker accounts), the data source (rugcheck), and the timestamp of when the data was fetched.","failureModes":["Invalid or non-existent mint address returns an error or empty result","Limit out of range (outside 1-20) may return a validation error","Rugcheck data source may lag behind very recent token launches","Network or upstream API timeout from rugcheck data provider","Payment failure (insufficient USDC) prevents the call from completing"],"whenToPreferThis":"Use this endpoint when you need on-chain Solana token holder distribution data including concentration metrics and insider flags, especially for DeFi risk screening, token due diligence, or whale-watch monitoring. It draws from rugcheck, making it particularly useful for rug-pull detection workflows. Prefer it over generic blockchain RPC calls when you need pre-aggregated concentration statistics without building your own holder indexer.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:49:06.125Z","isFirstParty":false}