This endpoint requires a Growth or Enterprise plan. Learn more.
Returns
TokenWalletFilterConnection!
required
Show Properties
Show Properties
[TokenWalletFilterResult!]!
required
The list of wallets matching the filter parameters.
Show Properties
Show Properties
The total balance of tokens that the user has bought or sold. This value does not include tokens acquired through external transfers or unsupported methods.
The total balance of tokens held by the user, reflecting the most recent update to the record. This balance includes all tokens, even those transferred in through unsupported methods or DEXs that are not tracked by our system. This value does not update with every transfer and can be slightly stale. Use tokenBalanceLive for live data.
The current token balance in the wallet. This value is updated with every transfer and is therefore more accurate than tokenBalance.
EnhancedToken!
required
The token metadata
Show Properties
Show Properties
The precision to which the token can be divided. For example, the smallest unit for USDC is 0.000001 (6 decimals).
Community gathered links for the socials of this token.
More metadata about the token.
Show Properties
Show Properties
A list of exchanges where the token has been traded.
Show Properties
Show Properties
Returns mint authority address if token is mintable. If null, verify against isMintableValid.
Returns freeze authority address if token is freezable. If null, verify against isFreezableValid.
Determines if freezable is a valid address or null value for the authority, or if the freezable state has not yet been determined.
Determines if mintable is a valid address or null value for the authority, or if the mintable state has not yet been determined.
The launchpad data for the token, if applicable.
Show Properties
Show Properties
The total supply of the token.
This field is deprecated. Use the TokenInfo type
ExplorerTokenData
deprecated
Information about the token from 3rd party sources.
This field is deprecated. Use the TokenInfo type
Show Properties
Show Properties
The thumbnail token logo URL.
This field is deprecated. Use the TokenInfo type
The small token logo URL.
This field is deprecated. Use the TokenInfo type
The large token logo URL.
This field is deprecated. Use the TokenInfo type
The circulating supply of the token.
This field is deprecated. Use the TokenInfo type
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
FilterTokenWalletsInput!
required
Show Properties
Show Properties
The IDs of the tokens to filter wallets for. Maximum 50 tokenIds. If you provide more than one tokenId, you must also provide at least one walletAddress in the wallets list.
A set of filters to apply
Show Properties
Show Properties
A list of ranking attributes to apply
Show Properties
Show Properties
WalletTokenRankingAttribute!
required
The attribute to rank wallets by
Show Properties
Show Properties
The first transaction timestamp
The last transaction timestamp
Token amount bought in the past day
Token amount sold in the past day
Amount bought in USD in the past day
Amount sold in USD in the past day
Realized profit in USD in the past day
Realized profit percentage in the past day
Number of buys in the past day
Number of sells in the past day
Token amount bought in the past week
Token amount sold in the past week
Amount bought in USD in the past week
Amount sold in USD in the past week
Realized profit in USD in the past week
Realized profit percentage in the past week
Number of buys in the past week
Number of sells in the past week
Token amount bought in the past 30 days
Token amount sold in the past 30 days
Amount bought in USD in the past 30 days
Amount sold in USD in the past 30 days
Realized profit in USD in the past 30 days
Realized profit percentage in the past 30 days
Number of buys in the past 30 days
Number of sells in the past 30 days
Token amount bought in the past year
Token amount sold in the past year
Amount bought in USD in the past year
Amount sold in USD in the past year
Realized profit in USD in the past year
Realized profit percentage in the past year
Number of buys in the past year
Number of sells in the past year
The total balance of tokens held by the user, reflecting the most recent update to the record. This balance includes all tokens, even those transferred in through unsupported methods or DEXs that are not tracked by our system.
The total balance of tokens that the user has bought or sold. This value does not include tokens acquired through external transfers or unsupported methods.
Token acquisition cost in USD
The scammer score for the wallet.
The bot score for the wallet.
RankingDirection!
required
Exclude wallets with these labels. See
WalletLabel for possible values.Include wallets with these labels. See
WalletLabel for possible values.The ID of the token to filter wallets for
This field is deprecated. Use tokenIds instead
The wallet address to filter wallets for
This field is deprecated. Use wallets instead
WalletTokenFilters
deprecated
A set of filters to apply
This field is deprecated. Use filtersV2 instead
Show Properties
Show Properties