Balance

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

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.

Community gathered links for the socials of this token. See SocialLinks

Show Properties

String

TokenInfo

More metadata about the token. See TokenInfo

Show Properties

String!

Uniquely identifies the token.

String!

The contract address of the token.

String

The circulating supply of the token.

Int

The token ID on CoinMarketCap.

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-).

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.

String

The total supply of the token.

String

The thumbhash of the token logo.

String

The thumbnail token logo URL.

String

The small token logo URL.

String

The large token logo URL.

String

The token banner URL.

String

The original URL/URI for the video associated with the token.

String

A description of the token.

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. Null when the token is reached through AssetDeployment.token. See Organization

Show Properties

String!

The organization name.

String

The founding date of the organization.

String

A short description of the organization.

String

A detailed description of the organization.

String

The organization’s tagline.

String

The type of organization (e.g. protocol, company).

String

The sector the organization operates in.

[OrganizationUrl!]!

URLs associated with the organization. See OrganizationUrl

[OrganizationSocial!]!

Social links for the organization. See OrganizationSocial

String

The organization’s logo URL.

String

The organization’s icon URL.

String

String!

The Grid root ID for the organization.

[Asset!]!

Assets managed by this organization. See Asset

Asset

The Grid asset associated with this token. Null when the token is reached through AssetDeployment.token. See Asset

Show Properties

String!

The Grid asset ID.

String

The asset name.

String

A description of the asset.

String

The asset ticker symbol.

String

The asset type (e.g. token, stablecoin).

String

The asset status.

String

The asset icon URL.

String!

The Grid root ID for the parent organization.

[AssetDeployment!]!

Deployments of this asset across chains. See AssetDeployment

[Exchange!]

A list of exchanges where the token has been traded. See Exchange

Show Properties

String!

The ID of the exchange (address:id).

String!

The contract address of the exchange.

String

The hex string for the exchange color.

String

The name of the exchange.

String

The version of the exchange, if applicable.

String

The exchange logo URL.

Int!

The network ID the exchange is deployed on.

String

The URL for the exchange.

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

Show Properties

String!

WalletCategory

See WalletCategory

Int

WalletFunding

See WalletFunding

[String!]

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.

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!]

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.

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.

String

The token creator’s network-based token balance at time of contract creation.

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

Show Properties

String

The name of the launchpad.

Float

The percentage of the pool that was sold to the public.

String

The address of the pool.

Int

The unix timestamp when the launchpad was completed.

Boolean

Indicates if the launchpad is completed.

Int

The slot number when the launchpad was completed.

Int

The slot number when the launchpad was migrated.

Int

The unix timestamp when the launchpad was migrated.

Boolean

Indicates if the launchpad was migrated.

String

The pool address after the launchpad was migrated.

String

The launchpad protocol.

String

The icon URL of the launchpad.

Boolean

Whether cashback is enabled for this launchpad token (Pump V1/V2 only).

String

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.

String

deprecated

The name of the launchpad.

This field is deprecated. Use launchpadName instead

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

Show Properties

String!

The token ID (address:networkId).

String!

The contract address of the token.

Int!

The network ID the token is deployed on.

String!

The all-time high price in USD.

Int!

The unix timestamp when the all-time high price was reached.

String!

The all-time low price in USD.

Int!

The unix timestamp when the all-time low price was reached.

String!

The all-time high fully diluted market cap.

Int!

The unix timestamp when the all-time high FDV was reached.

String!

The all-time low fully diluted market cap.

Int!

The unix timestamp when the all-time low FDV was reached.

String!

The all-time high circulating market cap.

Int!

The unix timestamp when the all-time high circulating market cap was reached.

String!

The all-time low circulating market cap.

Int!

The unix timestamp when the all-time low circulating market cap was reached.

CoinCommunity

The Coin Community data for the token See CoinCommunity

Show Properties

String!

The id of the coin community

Int!

The unix timestamp for the creation of the coin community.

Int!

The number of posts in the coin community.

Int!

The number of members in the coin community.

Int!

The number of likes in the coin community.

Int

The unix timestamp for the most recent post in the coin community.

TokenExtensions

Token extension metadata, if available. See TokenExtensions

Show Properties

Token2022Extensions

Solana Token-2022 extension metadata. See Token2022Extensions

B20Extensions

Base B20 extension metadata. See B20Extensions

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 Erc7572CustomInfo

Show Properties

String!

Token-standard discriminant for this custom data (currently always erc7572).

String

Featured/showcase image URL from the contract metadata.

[String!]

Collaborator wallet addresses listed in the contract metadata.

[Category!]

See Category

Show Properties

String!

The category id — a stable slug (also the value stored on tokens).

String!

The display name. For example, Artificial Intelligence.

String

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.

String!

The URL slug (same value as id).

String

A short description of the category.

CategoryType!

Whether the category is canonical or narrative. See CategoryType

CategoryStatus!

The lifecycle status of the category. See CategoryStatus

String

The parent category id, for hierarchical categories.

Int

The number of tokens currently assigned to the category. Null when the count has not been computed yet.

String

deprecated

The category icon URL.

This field is deprecated. Categories no longer carry imagery. Will be null.

String

deprecated

The category banner image URL.

This field is deprecated. Categories no longer carry imagery. Will be null.

TokenRisk

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 TokenRisk

Show Properties

RiskVerdict

The verdict. Null when the token has not been assessed. See RiskVerdict

Float

Weighted score from 0 to 100, computed from weighted signals with family caps and a corroboration bonus, then clamped. Null for a terminal verdict reached without scoring, and for an unassessed token. Not a probability.

Int

Unix seconds when the engine last recorded a change to this token’s risk assessment, the first recorded observation included. A re-evaluation that reaches the same result records nothing, so this tracks change rather than evaluation. Null when the token has never been assessed.

Int

Unix seconds of the contract analysis the verdict rests on: the decisive analysis, or the newest reading of a proven trapped pool. Moves only when the contract is probed again, unlike flaggedAt. Null when neither stands behind the verdict.

RiskAnalysisCoverage

How much contract analysis stood behind the verdict. Null when unassessed, or when a terminal verdict was reached without establishing analysis coverage. See RiskAnalysisCoverage

[RiskReasonCode!]

The reason codes behind the verdict, unordered. Empty when nothing fired; null when unassessed. New codes are added over time, so do not assume this list is exhaustive or that a familiar set is the whole picture. See RiskReasonCode

String

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

Show Properties

String!

The ID of the token (address:networkId).

Boolean

Whether the token has been verified on CoinGecko.

String

A description of the token.

String

The precision to which the token can be divided.

String

The token price in USD.

String

The token 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 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.

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

String

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.

Int

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.

Boolean

True when this row is the ERC-20 alias projection (a same-block floor of the native holding, in balanceDecimals) rather than the authoritative native view; false for the native view. Null elsewhere.

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, persisting the result so subsequent balances queries reflect it. Supports contract tokens (<tokenAddress>:<networkId>, EVM only) and native token balances (native:<networkId>, EVM, Solana, and Starknet). Entries that cannot be refreshed (e.g. an unreachable network) are omitted from the response rather than erroring.

API Documentation

Queries

Mutations

Subscriptions

Types

Used By

​Used By

Used By