---
name: token-holders
description: Read a Solana token's holders - holder count, 24h change in holders, the share held by the top holders, dev mints, and whether mint and freeze authority are disabled. Optionally lists the 20 largest holder accounts when SOLANA_RPC_URL is set. Use when the user asks who holds a token, how many holders it has, or how concentrated or risky its supply is.
---

# Token holders

Free and read-only. Works out of the box on Jupiter's public token data. No key needed.

## Run

```bash
node scripts/holders.mjs <mint>
node scripts/holders.mjs JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN
```

Optional: set `SOLANA_RPC_URL` to your own Solana RPC (any provider's free tier) to also get
the 20 largest holder accounts with their owners. The public Solana RPC blocks this call, so
without your own RPC that part is skipped and `largest` is `null`.

## Output

JSON on stdout: `{ mint, symbol, name, holderCount, holderChange24hPct, topHoldersPct,
devMints, mintAuthorityDisabled, freezeAuthorityDisabled, organicScore, isVerified,
largest: null | [ { rank, tokenAccount, owner, amount, pctOfSupply } ] }`.

## Notes for the agent

- `topHoldersPct` is Jupiter's share of supply held by the top holders. High values (over
  50%) mean a few wallets can move the price; say so plainly.
- Mint authority still enabled means more tokens can be created. Freeze authority enabled
  means holder accounts can be frozen.
- Some large holders are pools, exchanges or lockers, not people. Don't call them whales
  without checking.