[TokenWalletFilterResult!]!
The list of wallets matching the filter parameters.
See TokenWalletFilterResult
Show Properties
Show Properties
String!
The wallet address
String!
The token address
Int!
The network ID
Int
The unix timestamp for the first transaction from this wallet
Int!
The unix timestamp for the last transaction from this wallet
[String!]!
The labels associated with the wallet
String!
Token amount bought in the past day
String!
Token amount sold in the past day
String!
Token amount sold all in the past day
String!
Amount bought in USD in the past day
String!
Amount sold in USD in the past day
String!
Amount sold USD all in the past day
String!
Realized profit in USD in the past day
Float!
Realized profit percentage in the past day
Float
Average hold period, in seconds, for positions sold during the past day. Estimated with average-cost accounting: sells realize the age of the sold cost basis, so unsold holdings do not affect the result. A lower bound, capped at the window length. Returns null when under $1 of cost basis was sold.
Int!
Number of buys in the past day
Int!
Number of sells in the past day
Int!
Number of sells all in the past day
String!
Token amount bought in the past week
String!
Token amount sold in the past week
String!
Token amount sold all in the past week
String!
Amount bought in USD in the past week
String!
Amount sold in USD in the past week
String!
Amount sold USD all in the past week
String!
Realized profit in USD in the past week
Float!
Realized profit percentage in the past week
Float
Average hold period, in seconds, for positions sold during the past week. Estimated with average-cost accounting: sells realize the age of the sold cost basis, so unsold holdings do not affect the result. A lower bound, capped at the window length. Returns null when under $1 of cost basis was sold.
Int!
Number of buys in the past week
Int!
Number of sells in the past week
Int!
Number of sells all in the past week
String!
Token amount bought in the past 30 days
String!
Token amount sold in the past 30 days
String!
Token amount sold all in the past 30 days
String!
Amount bought in USD in the past 30 days
String!
Amount sold in USD in the past 30 days
String!
Amount sold USD all in the past 30 days
String!
Realized profit in USD in the past 30 days
Float!
Realized profit percentage in the past 30 days
Float
Average hold period, in seconds, for positions sold during the past 30 days. Estimated with average-cost accounting: sells realize the age of the sold cost basis, so unsold holdings do not affect the result. A lower bound, capped at the window length. Returns null when under $1 of cost basis was sold.
Int!
Number of buys in the past 30 days
Int!
Number of sells in the past 30 days
Int!
Number of sells all in the past 30 days
String!
Token amount bought in the past year
String!
Token amount sold in the past year
String!
Token amount sold all in the past year
String!
Amount bought in USD in the past year
String!
Amount sold in USD in the past year
String!
Amount sold USD all in the past year
String!
Realized profit in USD in the past year
Float!
Realized profit percentage in the past year
Float
Average hold period, in seconds, for positions sold during the past year. Estimated with average-cost accounting: sells realize the age of the sold cost basis, so unsold holdings do not affect the result. A lower bound, capped at the window length. Returns null when under $1 of cost basis was sold.
Int!
Number of buys in the past year
Int!
Number of sells in the past year
Int!
Number of sells all in the past year
String!
The token acquisition cost in USD
String!
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.
String!
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.
String
The current token balance in the wallet. This value is updated with every transfer and is therefore more accurate than tokenBalance.
String
The current USD value of the token balance.
EnhancedToken!
The token metadata
See EnhancedToken
Show Properties
Show Properties
String!
The ID of the token (
address:networkId).String!
The contract address of the token.
Int
The token ID on CoinMarketCap.
Int!
The precision to which the token can be divided. For example, the smallest unit for USDC is 0.000001 (6 decimals).
Boolean
Whether the token has been flagged as a scam.
String
The token name. For example,
ApeCoin.Int!
The network ID the token is deployed on.
String
The token symbol. For example,
APE.SocialLinks
Community gathered links for the socials of this token.
See SocialLinks
String
The Grid asset ID, if this token is linked to a Grid asset.
String
The Grid bluechip rating for this token (e.g.
A+, B-).Organization
The Grid organization associated with this token.
See Organization
String
The token creator’s wallet address.
Wallet
The token creator’s wallet identity and profile, resolved from creatorAddress. Null when the token has no known creator.
See Wallet
Int
The block height the token was created at.
String
The transaction hash of the token’s creation.
Int
The unix timestamp for the creation of the token.
String
Returns mint authority address if token is mintable. If null, verify against isMintableValid.
String
Returns freeze authority address if token is freezable. If null, verify against isFreezableValid.
Boolean
Determines if freezable is a valid address or null value for the authority, or if the freezable state has not yet been determined.
Boolean
Determines if mintable is a valid address or null value for the authority, or if the mintable state has not yet been determined.
LaunchpadData
The launchpad data for the token, if applicable.
See LaunchpadData
Float
The percentage of total supply held by the top 10 holders (excluding exchanges/pairs).
Boolean
Whether the token name or symbol contains profanity.
TokenExtrema
All-time high and low price/market cap data for the token.
See TokenExtrema
CoinCommunity
The Coin Community data for the token
See CoinCommunity
TokenExtensions
Token extension metadata, if available.
See TokenExtensions
Erc7572CustomInfo
Token-standard-specific custom metadata — currently ERC-7572
contractURI fields, as used by Base B20 tokens. Null for tokens without a recognized token standard.
See Erc7572CustomInfoString
deprecated
The total supply of the token.
This field is deprecated. Use the TokenInfo type
ExplorerTokenData
deprecated
Information about the token from 3rd party sources.
See ExplorerTokenData
This field is deprecated. Use the TokenInfo type
String
deprecated
The thumbnail token logo URL.
This field is deprecated. Use the TokenInfo type
String
deprecated
The small token logo URL.
This field is deprecated. Use the TokenInfo type
String
deprecated
The large token logo URL.
This field is deprecated. Use the TokenInfo type
String
deprecated
The circulating supply of the token.
This field is deprecated. Use the TokenInfo type
String
deprecated
The amount of this token in the pair.
This field is deprecated. Pooled can be found on the pair instead
Int
The scammer score for the wallet.
Int
The bot score for the wallet.
WalletAggregateBackfillState
The backfill state of the wallet.
See WalletAggregateBackfillState
Show Properties
Show Properties
enum
Historical stats calculations for this wallet have been successfully processed
enum
Historical stats calculations for this wallet are being processed
enum
Historical stats calculations were started, then canceled for this wallet. It may have been flagged as a bot
enum
Historical stats calculations have been blocked for this wallet. It may have been flagged as a bot
enum
Historical stats calculations for this wallet are queued and will be processed soon
enum
Historical stats calculations for this wallet have not been started, nor attempted
Int!
The number of wallets returned.
Int!
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.