Skip to main content
Choose a holder endpoint based on the number of wallets you need: top 20, top 100, or the full paginated list. Use wallet balances and supply percentages to show how holdings are distributed.

Top 100 holders

Use top 100 holders for a ranked holder table without pagination.

Top 20 holders

Use top 20 holders when only the largest positions matter.
Quick concentration check:

All holders (paginated)

Use paginated holders for a full export or a supply-distribution snapshot. Each page can contain up to 5,000 holders. Pass the response’s cursor unchanged in the next request. Continue until there is no next page.

Holder concentration analysis

Sum the largest holders’ percentages to measure concentration. Check wallet labels before treating pool accounts or other infrastructure accounts as individual traders. 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

For live count and concentration changes, follow the holder updates guide. Use paginated REST snapshots when you need the full wallet list.