Int!
The number of different wallets holding the token.
String!
The ID of the token (
tokenAddress:networkId).String!
The token’s contract address.
Int!
The network ID that the token is deployed on.
[Balance!]!
The list of wallets holding the token.
See Balance
Show Properties
Show Properties
String!
The ID of the wallet (
walletAddress:networkId).String!
The ID of the token (
tokenAddress:networkId).String!
The wallet address.
Int!
The wallet network.
String!
The contract address of the token.
String!
The balance held by the wallet.
Float!
The balance held by the wallet, adjusted by the number of decimals in the token.
Float
The wallet balance expressed for UI display. Defaults to shiftedBalance. For Token-2022 tokens, RAW divides out the active UI amount multiplier. For B20 asset tokens, SCALED multiplies by the active multiplier so the value reflects redeemable units rather than raw token count. IMPORTANT: that B20 adjustment is applied ONLY by the
balances query, which is the one place a uiAmountMode is resolved. Every other source of a Balance — holders, refreshBalances, primeBalance, and the subscriptions — returns the raw shiftedBalance here, so the same holding can read differently across them. Display only: it does not share units with tokenPriceUsd, so do not multiply the two.String
The balance held by the wallet in USD. Computed from
shiftedBalance, NOT from uiBalance — for a B20 asset token those differ by the token’s multiplier, so do not recompute this as uiBalance * tokenPriceUsd.String
The token price in USD, per raw token — the same units as
shiftedBalance. For a B20 asset token this does NOT pair with uiBalance, which is multiplier-adjusted; multiplying the two over-counts by the multiplier. Use balanceUsd for position value.Int
The time that this address first held a token.
Int
The block number at which this balance was last updated. Null when the block is unknown (e.g. native balances) or the underlying balance record cannot be found.
EnhancedToken
Metadata for the token.
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
String
The token’s route-backed liquidity in USD: the real liquidity supporting the token price, summed across the token’s pairs with valid routing liquidity. Quote assets (a network’s base token and stablecoins) have no route of their own, so they report pool liquidity instead. Null when this stat has not been computed for the token yet.
Int
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.
Wallet
Identity and profile metadata for the wallet holding this balance. Not always available.
See Wallet
Show Properties
Show Properties
String!
WalletCategory
See WalletCategory
Int
WalletFunding
See WalletFunding
[String!]
Identity labels describing what this wallet is (e.g. CEX, DEX, bridge, team)
String
Resolved profile avatar URL (best available source)
String
A human-readable display name for the wallet
String
Twitter/X numeric ID
String
Twitter/X username
String
Telegram numeric ID
String
Telegram username
String
Website URL
String
Discord numeric ID
String
Discord username
String
GitHub numeric ID
String
GitHub username
String
Farcaster numeric ID
String
Farcaster username
String
A community-contributed description of the wallet
Int
Ethos credibility score (0-2800, higher = more trustworthy)
String
Ethos credibility tier (1-10)
Boolean
Ethos Network verification status
String
Source of identity data (e.g. ethos, manual, polymarket-backfill)
Int
When identity data was last updated (unix timestamp)
WalletPolymarketProfile
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
Int
Total number of tokens created by this wallet across all networks (where the creator is known).
Int
Total number of launchpad tokens migrated (graduated) by this wallet across all networks.
Used By
Returned by- onHoldersUpdated: Live-streamed list of wallets that hold a given token. Also has the unique count of holders for that token.