Skip to main content
Knowing who holds a token is critical before buying. If a few wallets hold most of the supply, those wallets can move the market or create serious risk. The Data API gives you three endpoints depending on how much holder data you need.

Top 100 Holders

The top 100 holders endpoint returns the largest wallets by balance — fast, no pagination needed.

Top 20 Holders

The top 20 holders endpoint is a lighter call — useful for quick whale concentration checks without pulling the full 100.
Quick concentration check:

All Holders (Paginated)

For a full export of every holder — needed for building a holder dashboard, tracking supply distribution over time, or doing deep risk analysis — use the paginated holders endpoint. It supports up to 5,000 holders per page. Cursor pagination means the response gives you a nextCursor. Send that cursor in the next request to get the next page.

Holder Concentration Analysis

Once you have the holder list, you can calculate supply concentration. This shows how much of the token supply is controlled by the largest wallets. Holder table showing wallet labels beside top token holders
Cross-reference holder data with the risk score returned by the token info endpoint — it already factors in top-10 concentration and single-wallet ownership thresholds. See the Token Safety & Rugcheck guide for details.

Use Cases


Live Holder Updates

To track holder changes in real time — new holders, whale exits, and creator-wallet sell-offs — use the Datastream WebSocket. See the Live Token Holder Updates guide.