Skip to main content

​
Returns

​
Arguments

​
Usage Guidelines

  • Query using tokenIds array with token IDs in address:networkId format
  • Use rankings to sort results by any stat attribute (e.g., realizedProfitUsd30d, tokenBalance)
  • Stats are available in multiple time windows: 1d, 1w, 30d, 1y
  • Use filtersV2 to filter wallets by numeric ranges (e.g., minimum profit, minimum buys)
  • tokenBalance is the last known balance; use tokenBalanceLive for real-time balance
  • Use includeLabels and excludeLabels to filter by wallet labels (e.g., smart money, bots)
  • Maximum of 50 token IDs per query; multiple tokens require at least one wallet address

​
Troubleshooting Tips

Use filterTokenWallets when you want to find wallets that have traded a specific token and see their stats for that token only — great for finding top holders or profitable traders of a particular token. Use filterWallets when you want to discover wallets based on their overall trading performance across all tokens.
tokenBalance is updated periodically and may be slightly stale. tokenBalanceLive is updated with every transfer and reflects the current balance. Use tokenBalanceLive when accuracy is critical.
tokenBalance includes all tokens held, including those received via transfers. purchasedTokenBalance only includes tokens acquired through tracked buys/sells on supported DEXs, excluding airdrops and transfers.
Only wallets that have traded the token on tracked DEXs are included. Wallets that received tokens via transfer only (airdrops, direct sends) may not appear.
botScore estimates likelihood the wallet is automated (0-100, higher = more likely bot). scammerScore estimates likelihood of fraudulent activity. Use these to filter out suspicious wallets.
Use rankings: [{ attribute: realizedProfitUsd30d, direction: DESC }] to sort by profit. Combine with filtersV2 to set minimum thresholds like realizedProfitUsd30d: { gte: 1000 }.