Returns top wallets across all supported networks using a wide range of filters, labels and rankings
This endpoint is available on Codex Growth and Enterprise Plans
Endpoint: filterWallets
This endpoint enables cross-chain wallet discovery, aggregating and ranking wallets across multiple networks (or filter for a specific networkID). It supports a range of ranking attributes such as total volume, number of swaps, win rate, PnL metrics and more, making it ideal for building wallet leaderboards or identifying top-performing wallets.
To see an example of this endpoint in action, visit https://www.defined.fi/traders/discover
Method: POST
Arguments
| Name | Type | Description |
|---|---|---|
| input | FilterWalletsInput! | Required |
| Name | Type | Description |
|---|---|---|
| excludeLabels | [String] | Exclude wallets with these labels. |
| filters | WalletFilters | A set of filters to apply. |
| includeLabels | [String] | Include wallets with these labels. |
| limit | Int | The maximum number of wallets to return. |
| offset | Int | Where in the list the server should start when returning items. Use |
| rankings | [WalletRanking] | A list of ranking attributes to apply. |
| wallets | [String] | A list of wallet addresses to filter by. |
Response
| Name | Type | Description |
|---|---|---|
| count | Int! | The number of wallets returned. |
| offset | Int! | Where in the list the server started when returning items. |
| results | [WalletFilterResult!]! | The list of wallets matching the filter parameters. |
| Name | Type | Description |
|---|---|---|
| address | String! | The wallet address |
| averageProfitUsdPerTrade1d | String! | Average profit in USD per trade in the past day |
| averageProfitUsdPerTrade1w | String! | Average profit in USD per trade in the past week |
| averageProfitUsdPerTrade1y | String! | Average profit in USD per trade in the past year |
| averageProfitUsdPerTrade30d | String! | Average profit in USD per trade in the past 30 days |
| averageSwapAmountUsd1d | String! | Average swap amount in USD in the past day |
| averageSwapAmountUsd1w | String! | Average swap amount in USD in the past week |
| averageSwapAmountUsd1y | String! | Average swap amount in USD in the past year |
| averageSwapAmountUsd30d | String! | Average swap amount in USD in the past 30 days |
| botScore | Int | The bot score for the wallet. |
| firstTransactionAt | Int | The unix timestamp for the first transaction from this wallet |
| labels | [String!]! | The labels associated with the wallet |
| lastTransactionAt | Int! | The unix timestamp for the last transaction from this wallet |
| nativeTokenBalance | String | The native token balance of the wallet (only present if filtered by network) |
| networkId | Int | The network ID of the wallet (only present if filtered by network) |
| realizedProfitPercentage1d | Float! | Realized profit percentage in the past day |
| realizedProfitPercentage1w | Float! | Realized profit percentage in the past week |
| realizedProfitPercentage1y | Float! | Realized profit percentage in the past year |
| realizedProfitPercentage30d | Float! | Realized profit percentage in the past 30 days |
| realizedProfitUsd1d | String! | Realized profit in USD in the past day |
| realizedProfitUsd1w | String! | Realized profit in USD in the past week |
| realizedProfitUsd1y | String! | Realized profit in USD in the past year |
| realizedProfitUsd30d | String! | Realized profit in USD in the past 30 days |
| scammerScore | Int | The scammer score for the wallet. |
| swaps1d | Int! | Number of swaps in the past day |
| swaps1w | Int! | Number of swaps in the past week |
| swaps1y | Int! | Number of swaps in the past year |
| swaps30d | Int! | Number of swaps in the past 30 days |
| swapsAll1d | Int! | Total number of swaps in the past day including all tokens |
| swapsAll1w | Int! | Total number of swaps in the past week including all tokens |
| swapsAll1y | Int! | Total number of swaps in the past year including all tokens |
| swapsAll30d | Int! | Total number of swaps in the past 30 days including all tokens |
| uniqueTokens1d | Int! | Number of unique tokens traded in the past day |
| uniqueTokens1w | Int! | Number of unique tokens traded in the past week |
| uniqueTokens1y | Int! | Number of unique tokens traded in the past year |
| uniqueTokens30d | Int! | Number of unique tokens traded in the past 30 days |
| volumeUsd1d | String! | Volume in USD in the past day |
| volumeUsd1w | String! | Volume in USD in the past week |
| volumeUsd1y | String! | Volume in USD in the past year |
| volumeUsd30d | String! | Volume in USD in the past 30 days |
| volumeUsdAll1d | String! | Total volume in USD in the past day including all tokens |
| volumeUsdAll1w | String! | Total volume in USD in the past week including all tokens |
| volumeUsdAll1y | String! | Total volume in USD in the past year including all tokens |
| volumeUsdAll30d | String! | Total volume in USD in the past 30 days including all tokens |
| winRate1d | Float! | Win rate in the past day |
| winRate1w | Float! | Win rate in the past week |
| winRate1y | Float! | Win rate in the past year |
| winRate30d | Float! | Win rate in the past 30 days |
Explore
Currently available wallet labels:
SNIPER
SMART_TRADER_TOKENS_UNDER_TWO_DAYS_OLD
SMART_TRADER_TOKENS_OVER_TWO_DAYS_OLD
INTERESTING
MEGA_WEALTHY
MEDIUM_WEALTHY
WEALTHY
Note: Most wallets have not yet been checked in order to be assigned a scammerScore value. Scammer score (or risk score) is assigned on a scale of 0-100, with 0 being most legitimate, and 100 being most likely a scammer. Similarly, botScore will assign a value based on the likelihood of the wallet being a bot.
Ask questions, share what you're working on and request new features 👬👭