The list of wallets holding the token.
See Balance
Show Properties
Show Properties
The ID of the wallet (
walletAddress:networkId).The ID of the token (
tokenAddress:networkId).The wallet address.
The wallet network.
The contract address of the token.
The balance held by the wallet.
The balance held by the wallet, adjusted by the number of decimals in the token.
The wallet balance expressed for UI display. Defaults to shiftedBalance. When uiAmountMode is RAW, Token-2022 balances are divided by the active UI amount multiplier when available.
The balance held by the wallet in USD.
The token price in USD.
The time that this address first held a token.
Metadata for the token.
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
Token extension metadata, if available.
See TokenExtensions
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 Erc7572CustomInfoThe 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 liquidity of the token in USD.
Unix timestamp (seconds) of the token’s most recent trade/market event across all pools we track. Token-level (not specific to this wallet). Useful for filtering out dead/worthless tokens, e.g. no activity in months.
Identity and profile metadata for the wallet holding this balance. Not always available.
See Wallet
Show Properties
Show Properties
See WalletCategory
See WalletFunding
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
Twitter/X numeric ID
Twitter/X username
Telegram numeric ID
Telegram username
Website URL
Discord numeric ID
Discord username
GitHub numeric ID
GitHub username
Farcaster numeric ID
Farcaster username
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 unique count of holders for the token.
A cursor for use in pagination.
Status of holder. Disabled if on unsupported network or there is insufficient holder data.
See HoldersStatus
What percentage of the total supply do the top 10 holders hold.
Used By
Returned by- holders: Returns list of wallets that hold a given token, ordered by holdings descending. Also has the unique count of holders for that token.