The list of wallets matching the filter parameters.
See TokenWalletFilterResult
Show Properties
Show Properties
The wallet address
The token address
The network ID
The unix timestamp for the first transaction from this wallet
The unix timestamp for the last transaction from this wallet
The labels associated with the wallet
Token amount bought in the past day
Token amount sold in the past day
Token amount sold all in the past day
Amount bought in USD in the past day
Amount sold in USD in the past day
Amount sold USD all in the past day
Realized profit in USD in the past day
Realized profit percentage in the past day
Average hold period, in seconds, for positions sold during the past day. Calculated from cost-basis turnover using sold cost basis. Returns null when there are no sells.
Number of buys in the past day
Number of sells in the past day
Number of sells all in the past day
Token amount bought in the past week
Token amount sold in the past week
Token amount sold all in the past week
Amount bought in USD in the past week
Amount sold in USD in the past week
Amount sold USD all in the past week
Realized profit in USD in the past week
Realized profit percentage in the past week
Average hold period, in seconds, for positions sold during the past week. Calculated from cost-basis turnover using sold cost basis. Returns null when there are no sells.
Number of buys in the past week
Number of sells in the past week
Number of sells all in the past week
Token amount bought in the past 30 days
Token amount sold in the past 30 days
Token amount sold all in the past 30 days
Amount bought in USD in the past 30 days
Amount sold in USD in the past 30 days
Amount sold USD all in the past 30 days
Realized profit in USD in the past 30 days
Realized profit percentage in the past 30 days
Average hold period, in seconds, for positions sold during the past 30 days. Calculated from cost-basis turnover using sold cost basis. Returns null when there are no sells.
Number of buys in the past 30 days
Number of sells in the past 30 days
Number of sells all in the past 30 days
Token amount bought in the past year
Token amount sold in the past year
Token amount sold all in the past year
Amount bought in USD in the past year
Amount sold in USD in the past year
Amount sold USD all in the past year
Realized profit in USD in the past year
Realized profit percentage in the past year
Average hold period, in seconds, for positions sold during the past year. Calculated from cost-basis turnover using sold cost basis. Returns null when there are no sells.
Number of buys in the past year
Number of sells in the past year
Number of sells all in the past year
The token acquisition cost in USD
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.
The current USD value of the token balance.
The token metadata
See EnhancedToken
Show Properties
Show Properties
The ID of the token (
address:networkId).The contract address of the token.
The token ID on CoinMarketCap.
The precision to which the token can be divided. For example, the smallest unit for USDC is 0.000001 (6 decimals).
Whether the token has been flagged as a scam.
The token name. For example,
ApeCoin.The network ID the token is deployed on.
The token symbol. For example,
APE.Community gathered links for the socials of this token.
See SocialLinks
The Grid asset ID, if this token is linked to a Grid asset.
The Grid bluechip rating for this token (e.g.
A+, B-).The Grid organization associated with this token.
See Organization
The token creator’s wallet address.
The token creator’s wallet identity and profile, resolved from creatorAddress. Null when the token has no known creator.
See Wallet
The block height the token was created at.
The transaction hash of the token’s creation.
The unix timestamp for the creation of the token.
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.
See LaunchpadData
The percentage of total supply held by the top 10 holders (excluding exchanges/pairs).
Whether the token name or symbol contains profanity.
All-time high and low price/market cap data for the token.
See TokenExtrema
The Coin Community data for the token
See CoinCommunity
The total supply of the token.
This field is deprecated. Use the TokenInfo type
Information about the token from 3rd party sources.
See ExplorerTokenData
This field is deprecated. Use the TokenInfo type
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 amount of this token in the pair.
This field is deprecated. Pooled can be found on the pair instead
The scammer score for the wallet.
The bot score for the wallet.
The backfill state of the wallet.
See WalletAggregateBackfillState
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
The number of wallets returned.
Where in the list the server started when returning items.
Used By
Returned by- filterTokenWallets: Returns a list of wallets with stats narrowed down to a specific token.