Skip to main content

​
Returns

​
Arguments

​
Usage Guidelines

  • Use filters to narrow results by metrics like realizedProfitUsd, winRate, volumeUsd, swaps, etc. — available for multiple time periods: 1d, 1w, 30d, 1y
  • Filters use NumberFilter with gte, gt, lte, lt operators for range queries
  • Use rankings to sort results by any metric — specify attribute and direction (ASC or DESC)
  • Filter by networkId to scope results to a specific chain (e.g., 1399811149 for Solana)
  • Use includeLabels or excludeLabels to filter by wallet classifications like SMART_TRADER_TOKENS_OVER_TWO_DAYS_OLD, WEALTHY, SNIPER
  • Use limit and offset for pagination — the response includes count to help with page navigation
  • Pass a list of wallets to filter results to specific wallet addresses

​
Troubleshooting Tips

Use filterWallets when you want to discover wallets based on their overall trading performance across all tokens — great for finding top traders on a network. Use filterTokenWallets when you want to find wallets that have traded a specific token and see their stats for that token only.
All metrics are available across four time periods: 1d (24 hours), 1w (7 days), 30d (30 days), and 1y (1 year). Append the period to the metric name, e.g., realizedProfitUsd1w, winRate30d, volumeUsd1y.
Labels classify wallet behavior: SMART_TRADER_TOKENS_OVER_TWO_DAYS_OLD indicates 7.5K+profitonestablishedtokens,‘SNIPER‘indicates7.5K+ profit on established tokens, `SNIPER` indicates 3K+ profit on tokens launched within 1 hour, WEALTHY/MEGA_WEALTHY indicate high asset holdings (1M+/1M+/10M+). Use excludeLabels to filter out bots or known patterns.
winRate is a percentage (0–100) representing the portion of profitable trades. A winRate1w of 52 means 52% of trades in the last week were profitable. Use filters like winRate1w: { gte: 50 } to find wallets with above-average win rates.
volumeUsd only counts volume from tokens where we have a reliable USD price. volumeUsdAll includes volume from all tokens, even those without reliable pricing. Use volumeUsd for more conservative figures.