How to calculate a Solana token's top 10 holders percentage (and why explorers overstate it)
"Top 10 holders own 60%" sounds like a rug. Often the biggest holder is the coin's own bonding curve or liquidity pool. Here is how to get the holder list from the chain and compute a top-10 share that only counts real wallets.
The three RPC calls
getTokenSupply(mint): the total supply.getTokenLargestAccounts(mint): the 20 largest token accounts.getMultipleAccounts(those addresses, jsonParsed): who owns each token account.
A token account is not a wallet. One wallet can hold a token in several accounts, so merge by owner before ranking.
Why the raw number is wrong
For a pump.fun coin still on its curve, the unsold tokens sit in the bonding-curve account: often 30% or more of supply. After migration, the liquidity sits in the pool's vault. Both show up as the "largest holder". Neither is somebody's bag, and counting them makes every new coin look dangerously concentrated.
The trick: wallets are on the curve, programs are not
A wallet's address is a point on the ed25519 curve, because it has a private key. A program-derived address is deliberately off the curve, so no key can exist for it. Pools, bonding curves, vaults and locks are all program-derived. So:
- owner is on the curve → a wallet → counts toward the top 10
- owner is off the curve → a program's account → label it and leave it out
The check is pure maths on the 32 bytes of the address. No extra RPC call.
A real example
One pump.fun coin, read from mainnet:
| Figure | Value |
|---|---|
| Held by its bonding curve | 31.85% |
| Held by all program accounts | 35.22% |
| Top 10 wallets | 20.84% |
An explorer's "top 10" for that coin starts with the 31.85% curve. The honest figure is 20.84%.
Working code
sol-holders does all of it, for SPL and Token-2022 mints, with no dependencies:
export SOLANA_RPC_URL="https://your-rpc.example/?api-key=..."
npx github:blixvip/sol-holders <mint> --dev <dev wallet>
import { topHolders } from "sol-holders";
const r = await topHolders("<mint>", { rpcUrl: process.env.SOLANA_RPC_URL, dev: "<dev wallet>" });
r.top10Pct; // the ten biggest wallets, programs left out
r.top10PctWithPrograms; // what an explorer shows
r.programPct; // held by pools, curves, vaults and locks
r.dev; // { wallet, amount, pct }
r.holders; // [{ rank, owner, amount, pct, kind }]
Limits to know
- You need a keyed RPC. The free public Solana endpoint refuses
getTokenLargestAccounts. The free plans of the main providers serve it. - Top 20 accounts only. That is what the RPC returns. It is enough for a top-10 share, not for a full holder list.
- Program-owned is not always harmless. A team multisig or a vesting contract is program-owned too. The label tells you it is not a plain wallet, not whose it is.