The list of token balances that a wallet has.
See Balance
Show Properties
Show Properties
The wallet balance expressed for UI display. Defaults to shiftedBalance. For Token-2022 scaled UI amount tokens and B20 asset tokens, SCALED multiplies by the active multiplier, so the value matches the UI amount wallets show and, for B20, redeemable units rather than raw token count. IMPORTANT: that 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.The balance held by the wallet in USD. Computed from
shiftedBalance, NOT from uiBalance — for a B20 asset token or a Token-2022 scaled UI amount token those differ by the token’s multiplier, so do not recompute this as uiBalance * tokenPriceUsd.The token price in USD, per raw token — the same units as
shiftedBalance. For a B20 asset token or a Token-2022 scaled UI amount token this does NOT pair with uiBalance, which is multiplier-adjusted; multiplying the two over-counts by the multiplier. Use balanceUsd for position value.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.
Metadata for the token.
See EnhancedToken
Show Properties
Show Properties
The precision to which the token can be divided. For example, the smallest unit for USDC is 0.000001 (6 decimals).
Community gathered links for the socials of this token.
See SocialLinks
The token’s own X link, parsed: the account it names and what kind of link it is. Null when the token has none. How often it was reused is
info.twitterReuseCount.
See TokenTwitterLinkMore metadata about the token.
See TokenInfo
The Grid organization associated with this token. Null when the token is reached through
AssetDeployment.token.
See OrganizationThe Grid asset associated with this token. Null when the token is reached through
AssetDeployment.token.
See AssetA list of exchanges where the token has been traded.
See Exchange
The token creator’s wallet identity and profile, resolved from creatorAddress. Null when the token has no known creator.
See Wallet
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
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 Erc7572CustomInfoSee Category
Codex’s unified risk assessment for this token — one verdict, the score behind it, how much analysis stood behind that score, and the reasons that fired. Read
coverage before trusting verdict.
See TokenRiskThe issuer of a real-world-asset token, such as a tokenized stock. Null when the token has no known issuer.
See TokenIssuer
Information about the token from 3rd party sources.
See ExplorerTokenData
This field is deprecated. Use the TokenInfo type
The circulating supply of the token.
This field is deprecated. Use the TokenInfo type
The token’s liquidity in USD. On networks where the real-money total is enabled, this is
totalLiquidityUsd from filterTokens: the combined liquidity of its 15 deepest pools, leaving out pools with no trade in the last 7 days, where each pool counts only the real money the token can reach in one or two trades into the network’s pricing reference tokens (such as its main stablecoins), with each route counted once. Elsewhere, or until that total is computed for the token, it is the token’s route-backed liquidity, summed across its 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.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
Labels on the wallet’s profile: identity (e.g. CEX, DEX, KOL) and the behaviour our labelling jobs write (BOT, SCAMMER, VOLUME_BOT). See
WalletLabel.Registry entity ids of the apps this wallet trades through — e.g.
defined for defined.fi, or axiom. Means “trades through”, never “is owned by”: one routed trade is enough to appear here.ENS and SNS names that point at this wallet: ENS then SNS, each with its primary first, then A to Z. Refreshed weekly. Null when the wallet has none.
See WalletDomain
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
The economic asset this balance is a view of (
tokenAddress:networkId). On networks where one holding is readable through a native interface and an ERC-20 alias contract, both views share this id. Null elsewhere.The number of decimals
balance is expressed in for this view. A native view reports the native precision (18 on such networks); a contract view reports the alias contract’s decimals (6). token.decimals remains the contract’s metadata. Null elsewhere.Used By
Returned by- balances: Returns list of token balances that a wallet has.