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
realizedProfitPercentage1d
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
realizedProfitPercentage1w
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
realizedProfitPercentage30d
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
realizedProfitPercentage1y
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 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 More metadata about the token.
See TokenInfo Uniquely identifies the token.
The contract address of the token.
The circulating supply of the token.
The token ID on CoinMarketCap.
The Grid asset ID, if this token is linked to a Grid asset.
The Grid bluechip rating for this token (e.g. A+, B-).
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.
The total supply of the token.
The thumbhash of the token logo.
The thumbnail token logo URL.
The small token logo URL.
The large token logo URL.
The original URL/URI for the video associated with the token.
A description of the token.
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 founding date of the organization.
A short description of the organization.
A detailed description of the organization.
The organization’s tagline.
The type of organization (e.g. protocol, company).
The sector the organization operates in.
The organization’s logo URL.
The organization’s icon URL.
The Grid root ID for the organization.
Assets managed by this organization.
See Asset The Grid asset associated with this token.
See Asset A description of the asset.
The asset type (e.g. token, stablecoin).
The Grid root ID for the parent organization.
A list of exchanges where the token has been traded.
See Exchange The ID of the exchange (address:id).
The contract address of the exchange.
The hex string for the exchange color.
The name of the exchange.
The version of the exchange, if applicable.
The network ID the exchange is deployed on.
The URL for the exchange.
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 Identity labels describing what this wallet is (e.g. CEX, DEX, bridge, team)
Resolved profile avatar URL (best available source)
A human-readable display name for the wallet
A community-contributed description of the wallet
Ethos credibility score (0-2800, higher = more trustworthy)
Ethos credibility tier (1-10)
Ethos Network verification status
Source of identity data (e.g. ethos, manual, polymarket-backfill)
When identity data was last updated (unix timestamp)
Raw Polymarket profile data when this wallet is a Polymarket proxy. Polymarket takes priority over contributed/ethos for resolved displayName, twitterUsername, and avatarUrl.
See WalletPolymarketProfile Total number of tokens created by this wallet across all networks (where the creator is known).
Total number of launchpad tokens migrated (graduated) by this wallet across all networks.
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 name of the launchpad.
The percentage of the pool that was sold to the public.
The unix timestamp when the launchpad was completed.
Indicates if the launchpad is completed.
The slot number when the launchpad was completed.
The slot number when the launchpad was migrated.
The unix timestamp when the launchpad was migrated.
Indicates if the launchpad was migrated.
The pool address after the launchpad was migrated.
The icon URL of the launchpad.
Whether cashback is enabled for this launchpad token (Pump V1/V2 only).
The token category assigned by the launchpad. Populated by launchpads that publish a category taxonomy (e.g. Scale/Creator, Eitherway). Values include platform, meme, utility, etc.
The name of the launchpad. This field is deprecated. Use launchpadName instead
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 token ID (address:networkId).
The contract address of the token.
The network ID the token is deployed on.
The all-time high price in USD.
The unix timestamp when the all-time high price was reached.
The all-time low price in USD.
The unix timestamp when the all-time low price was reached.
The all-time high fully diluted market cap.
The unix timestamp when the all-time high FDV was reached.
The all-time low fully diluted market cap.
The unix timestamp when the all-time low FDV was reached.
The all-time high circulating market cap.
The unix timestamp when the all-time high circulating market cap was reached.
The all-time low circulating market cap.
The unix timestamp when the all-time low circulating market cap was reached.
The Coin Community data for the token
See CoinCommunity The id of the coin community
The unix timestamp for the creation of the coin community.
The number of posts in the coin community.
The number of members in the coin community.
The number of likes in the coin community.
The unix timestamp for the most recent post in the coin community.
The total supply of the token. This field is deprecated. Use the TokenInfo type
explorerData
ExplorerTokenData
deprecated
Information about the token from 3rd party sources.
See ExplorerTokenData This field is deprecated. Use the TokenInfo type
The ID of the token (address:networkId).
Whether the token has been verified on CoinGecko.
A description of the token.
The precision to which the token can be divided.
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.
backfillState
WalletAggregateBackfillState
The backfill state of the wallet.
See WalletAggregateBackfillState 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
Used By Returned by
filterTokenWallets : Returns a list of wallets with stats narrowed down to a specific token. 
