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

  1. getTokenSupply(mint): the total supply.
  2. getTokenLargestAccounts(mint): the 20 largest token accounts.
  3. 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:

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:

FigureValue
Held by its bonding curve31.85%
Held by all program accounts35.22%
Top 10 wallets20.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

Want it done for you?

This is the small, open version. Blix is the AI-powered Solana memecoin terminal it comes from: every pump.fun launch live, AI coin ratings, narratives, wallet and X tracking, and one-click trading with 0% fees. There is a public API and an MCP server too.

Start trading on BlixJoin the Discord

Help build it

sol-holders is open source and takes pull requests. There are good first issues with step-by-step instructions, and setup is git clone and npm test.

More guides

How to get a pump.fun token's market cap and bonding curve progress without an APIpump-curveHow to detect new pump.fun tokens in real time (and stream every trade)pump-streamHow to parse a Solana swap transaction for any DEXsolana-swap-parserHow to stop Solana RPC 429 errors (Too Many Requests)solana-rpc-poolWhy your Solana WebSocket stops receiving messages, and how to keep it alivesolana-ws-keepalive