Skip to main content

​
Returns

​
Arguments

holders vs filterTokenWallets: Use holders when you want the most accurate, up-to-date holder counts and balances. holders records are updated on every token transfer (including airdrops, direct sends, and swaps).Use filterTokenWallets when you need trader performance data like profit, buy/sell counts, and other trading stats. Those records are only updated on swaps.

​
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 cursor parameter for pagination through large holder lists
  • The count field returns the total unique holder count for the token
  • The top10HoldersPercent field shows concentration of holdings among top wallets

​
Troubleshooting Tips

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.
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.
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.
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.
  • Token Dashboard: Build a comprehensive token detail page with price, holders, trades, and real-time updates
  • Discover Tokens: Build token discovery pages with trending data, filters, and search