Filter Wallets (Token Stats)

Shows token-specific performance stats per wallet

ℹ️

This endpoint is available on Codex Growth and Enterprise Plans

Endpoint: filterTokenWallets

This endpoint is used to discover wallets based on their interactions with tokens. You can apply filters like volume, swap count, PnL, and holding patterns, and optionally focus on a specific token or wallet. It also supports label-based filtering, phrase search by token name/symbol, and network-specific queries.

Note: This endpoint focuses on swap events. If you see balance discrepancies due to other types of token events (such as burns), we recommend using [balances](https://docs.codex.io/reference/balances) for udpated token balances.

Method: POST

Arguments

Name	Type	Description
input	FilterTokenWalletsInput!	Required

FilterTokenWalletsInput

Name	Type	Description
excludeLabels	[String]	Exclude wallets with these labels.
filtersV2	WalletTokenFiltersV2	A set of filters to apply
includeLabels	[String]	Include wallets with these labels.
limit	Int	The maximum number of wallets to return
networkId	Int	The network ID to filter wallets for
offset	Int	Where in the list the server should start when returning items
phrase	String	A phrase to search for in token symbol and name
rankings	[WalletTokenRanking]	A list of ranking attributes to apply
tokenId	String	The ID of the token to filter wallets for
wallets	[String]	A list of wallet addresses to filter wallets for

Response

TokenWalletFilterConnection

Name	Type	Description
count	Int!	The number of wallets returned.
offset	Int!	Where in the list the server started when returning items.
results	[TokenWalletFilterResult!] !	The list of wallets matching the filter parameters.

TokenWalletFilterResult

Name	Type	Description
address	String!	The wallet address
amountBoughtUsd1d	String!	Amount bought in USD in the past day
amountBoughtUsd1w	String!	Amount bought in USD in the past week
amountBoughtUsd1y	String!	Amount bought in USD in the past year
amountBoughtUsd30d	String!	Amount bought in USD in the past 30 days
amountSoldUsd1d	String!	Amount sold in USD in the past day
amountSoldUsd1w	String!	Amount sold in USD in the past week
amountSoldUsd1y	String!	Amount sold in USD in the past year
amountSoldUsd30d	String!	Amount sold in USD in the past 30 days
amountSoldUsdAll1d	String!	Amount sold USD all in the past day
amountSoldUsdAll1w	String!	Amount sold USD all in the past week
amountSoldUsdAll1y	String!	Amount sold USD all in the past year
amountSoldUsdAll30d	String!	Amount sold USD all in the past 30 days
botScore	Int	The bot score for the wallet.
buys1d	Int!	Number of buys in the past day
buys1w	Int!	Number of buys in the past week
buys1y	Int!	Number of buys in the past year
buys30d	Int!	Number of buys in the past 30 days
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
networkId	Int!	The network ID
purchasedTokenBalance	String!	The purchased token balance
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.
sells1d	Int!	Number of sells in the past day
sells1w	Int!	Number of sells in the past week
sells1y	Int!	Number of sells in the past year
sells30d	Int!	Number of sells in the past 30 days
sellsAll1d	Int!	Number of sells all in the past day
sellsAll1w	Int!	Number of sells all in the past week
sellsAll1y	Int!	Number of sells all in the past year
sellsAll30d	Int!	Number of sells all in the past 30 days
token	EnhancedToken!	The token metadata
tokenAcquisitionCostUsd	String!	The token acquisition cost in USD
tokenAddress	String!	The token address
tokenAmountBought1d	String!	Token amount bought in the past day
tokenAmountBought1w	String!	Token amount bought in the past week
tokenAmountBought1y	String!	Token amount bought in the past year
tokenAmountBought30d	String!	Token amount bought in the past 30 days
tokenAmountSold1d	String!	Token amount sold in the past day
tokenAmountSold1w	String!	Token amount sold in the past week
tokenAmountSold1y	String!	Token amount sold in the past year
tokenAmountSold30d	String!	Token amount sold in the past 30 days
tokenAmountSoldAll1d	String!	Token amount sold all in the past day
tokenAmountSoldAll1w	String!	Token amount sold all in the past week
tokenAmountSoldAll1y	String!	Token amount sold all in the past year
tokenAmountSoldAll30d	String!	Token amount sold all in the past 30 days
tokenBalance	String!	The current token balance

Explore

Currently available wallet labels:

Wallet Label	Description
SNIPER	Profits $3k+ from tokens bought within 1 hour of launch
SMART_TRADER_TOKENS_UNDER_TWO_DAYS_OLD (Early Bird)	Profits $5k+ from tokens 1 hour to 2 days old
SMART_TRADER_TOKENS_OVER_TWO_DAYS_OLD (Second Wave)	Profits $7.5k+ from established tokens (2+ days old)
INTERESTING	REDACTED
WEALTHY	Wallet holds $1M+ in assets
MEDIUM_WEALTHY	Wallet holds $5M+ in assets
MEGA_WEALTHY	Wallet holds $10M+ in assets

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.

👋

Join our Discord

Ask questions, share what you're working on and request new features 👬👭