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
More metadata about the token.
See TokenInfo
Show Properties
Show Properties
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 token banner 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
Show Properties
Show Properties
The organization name.
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.
URLs associated with the organization.
See OrganizationUrl
Social links for the organization.
See OrganizationSocial
The organization’s logo URL.
The organization’s icon URL.
The Grid root ID for the organization.
The Grid asset associated with this token.
See Asset
Show Properties
Show Properties
The Grid asset ID.
The asset name.
A description of the asset.
The asset ticker symbol.
The asset type (e.g.
token, stablecoin).The asset status.
The asset icon URL.
The Grid root ID for the parent organization.
Deployments of this asset across chains.
See AssetDeployment
A list of exchanges where the token has been traded.
See Exchange
Show Properties
Show Properties
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 exchange logo URL.
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
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 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
Show Properties
Show Properties
The name of the launchpad.
The percentage of the pool that was sold to the public.
The address of the pool.
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 launchpad protocol.
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
Show Properties
Show Properties
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
Show Properties
Show Properties
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.
Token extension metadata, if available.
See TokenExtensions
Show Properties
Show Properties
Solana Token-2022 extension metadata.
See Token2022Extensions
Base B20 extension metadata.
See B20Extensions
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 Erc7572CustomInfoSee Category
Show Properties
Show Properties
The category id — a stable slug (also the value stored on tokens).
The display name. For example,
Artificial Intelligence.An optional short name/abbreviation for compact surfaces (pills, badges). For example,
AI. Null when unset — the API does not fall back to name; clients decide whether to.The URL slug (same value as
id).A short description of the category.
Whether the category is canonical or narrative.
See CategoryType
The lifecycle status of the category.
See CategoryStatus
The category icon URL.
The category banner image URL.
The parent category id, for hierarchical categories.
The number of tokens in the category (denormalized snapshot).
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
Show Properties
Show Properties
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 token price in USD.
The token 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
Used By
Returned by- balances: Returns list of token balances that a wallet has.
- holders: Returns list of wallets that hold a given token, ordered by holdings descending. Also has the unique count of holders for that token.
- onBalanceUpdated: Live-streamed balance updates for a given wallet.
- onHoldersUpdated: Live-streamed list of wallets that hold a given token. Also has the unique count of holders for that token.
- refreshBalances: Force refreshes the balance for a token in a wallet. EVM only.