This endpoint requires a Growth or Enterprise plan. Learn more.
Returns
WalletFilterConnection!
required
Show Properties
Show Properties
[WalletFilterResult!]!
required
The list of wallets matching the filter parameters.
Show Properties
Show Properties
The native token balance of the wallet (only present if filtered by network)
The backfill state of the wallet.
Show Properties
Show Properties
Historical stats calculations for this wallet have been successfully processed
Historical stats calculations for this wallet are being processed
Historical stats calculations were started, then canceled for this wallet. It may have been flagged as a bot
Historical stats calculations have been blocked for this wallet. It may have been flagged as a bot
Historical stats calculations for this wallet are queued and will be processed soon
Historical stats calculations for this wallet have not been started, nor attempted
Arguments
FilterWalletsInput!
required
Show Properties
Show Properties
A set of filters to apply.
Show Properties
Show Properties
Exclude wallets with these labels. See
WalletLabel for possible values.Include wallets with these labels. See
WalletLabel for possible values.A list of ranking attributes to apply.
Show Properties
Show Properties
The attribute to rank wallets by.
Show Properties
Show Properties
Usage Guidelines
- Use
filtersto narrow results by metrics likerealizedProfitUsd,winRate,volumeUsd,swaps, etc. — available for multiple time periods:1d,1w,30d,1y - Filters use
NumberFilterwithgte,gt,lte,ltoperators for range queries - Use
rankingsto sort results by any metric — specifyattributeanddirection(ASCorDESC) - Filter by
networkIdto scope results to a specific chain (e.g., 1399811149 for Solana) - Use
includeLabelsorexcludeLabelsto filter by wallet classifications likeSMART_TRADER_TOKENS_OVER_TWO_DAYS_OLD,WEALTHY,SNIPER - Use
limitandoffsetfor pagination — the response includescountto help with page navigation - Pass a list of
walletsto filter results to specific wallet addresses
Troubleshooting Tips
When should I use filterWallets vs filterTokenWallets?
When should I use filterWallets vs filterTokenWallets?
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.What time periods are available for metrics?
What time periods are available for metrics?
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.What do the wallet labels mean?
What do the wallet labels mean?
Labels classify wallet behavior:
SMART_TRADER_TOKENS_OVER_TWO_DAYS_OLD indicates 7.5K+profitonestablishedtokens,‘SNIPER‘indicates3K+ profit on tokens launched within 1 hour, WEALTHY/MEGA_WEALTHY indicate high asset holdings (1M+/10M+). Use excludeLabels to filter out bots or known patterns.How does winRate work?
How does winRate work?
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.What's the difference between volumeUsd and volumeUsdAll?
What's the difference between volumeUsd and volumeUsdAll?
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.