Usage Guidelines
- Response limit: 200 holders per request (default is 50)
- Results are ordered by holdings descending by default
- Use
sort: {attribute: DATE}to order by when wallets first acquired the token - Use the
cursorparameter for pagination through large holder lists - The
countfield returns the total unique holder count for the token - The
top10HoldersPercentfield shows concentration of holdings among top wallets
Troubleshooting Tips
Why is status returning DISABLED?
Why is status returning DISABLED?
The
status field returns DISABLED when the token is on an unsupported network or there is insufficient holder data available. Check that the token is on a supported network and has sufficient trading activity.Holder count seems lower than expected
Holder count seems lower than expected
We only track wallets that have acquired tokens through on-chain swaps. Wallets that received tokens through direct transfers or airdrops may not be included in the holder count until they perform a swap.
How can I get all holders for a token?
How can I get all holders for a token?
Use pagination with the
cursor parameter. After each request, use the returned cursor value in your next request to fetch the next page of holders until cursor returns null.What does top10HoldersPercent represent?
What does top10HoldersPercent represent?
This field shows the percentage of total token supply held by the top 10 wallets. A high percentage may indicate concentrated ownership, which can be a risk factor for some tokens.