TokenBarsResponse

[Float]!

The opening price.

[Float]!

The high price.

[Float]!

The low price.

[Float]!

The closing price.

[Int!]!

The timestamp for the bar.

String!

The status code for the batch: ok for successful data retrieval and no_data for empty responses signaling the end of server data.

[String]

The volume with higher precision.

[String]

The volume in the native token for the network

[Int]!

The number of unique buyers

[Int]!

The number of buys

[String]!

The buy volume in USD

[Int]!

The number of unique sellers

[Int]!

The number of sells

[String]!

The sell volume in USD

[String]!

Liquidity in USD

[String]

The token’s total supply when the bar was last updated, with decimals applied. Multiply by the bar’s prices for its fully diluted market cap. Carried forward through bars with no trades. 0 when the supply is unknown, null for bars last updated before supply was recorded (about 17:30 UTC on 2026-10-22).

[String]

The token’s circulating supply when the bar was last updated, with decimals applied. Multiply by the bar’s prices for its circulating market cap. Carried forward through bars with no trades. Total supply when circulating supply is unknown, null for bars last updated before supply was recorded (about 17:30 UTC on 2026-10-22).

[Int]!

The number of traders

[Int]!

The number of transactions

[String]

The aggregate pool/DEX fees in USD

[String]

The aggregate base fees (gas) in USD

[String]

The aggregate priority fees in USD

[String]

The aggregate builder tips (MEV) in USD

[String]

The aggregate L1 data posting fees in USD (L2 rollups only)

[String]

The total fees in USD (sum of poolFees + baseFees + priorityFees + builderTips + l1DataFees)

[String]

Ratio of total fees to volume (totalFees / volume). Null when volume is zero.

[String]

Ratio of builder tips (MEV) to total fees (builderTips / totalFees). Null when totalFees is zero.

[String]

Gas cost per dollar of volume ((baseFees + priorityFees + l1DataFees) / volume). Null when volume is zero.

[String]

Average total fee cost per transaction in USD (totalFees / transactions). Null when there are no transactions.

[String]

MEV risk level for this bar: low (<3% builder tips), medium (3-30%), or high (>30%). Null for pre-genesis bars.

[String]

Dominant fee component: gas-dominated (gas >50% of fees), mev-dominated (tips >20%), or pool-fee-dominated. Null when no fees.

[String]

Rate of sandwich attacks per transaction (sandwichedEventCount / transactions). Null when no transaction data.

EnhancedToken!

The token that is being returned 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.

[FeeMode!]

Where this launchpad token’s creator fees go (Pump and PumpAmm only). Pump tokens have exactly one mode. Not set for Pump tokens whose curve predates the cashback fields. See FeeMode

Int

The holder-reward fee rate in basis points. Null when the launchpad’s default fee schedule applies. Read when the token’s metadata was fetched; may be stale if the creator can edit the fee.

String

The mint of the token holder rewards are paid in.

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

Boolean

deprecated

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

This field is deprecated. Use feeModes instead; CASHBACK is in feeModes when cashback is enabled

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

RobinhoodStockTokenExtensions

Robinhood Chain stock token (tokenized equity) metadata. See RobinhoodStockTokenExtensions

XStockTokenExtensions

xStocks (Backed Finance tokenized equity) metadata, on EVM networks. Solana xStocks use token2022.scaledUiAmountConfig. See XStockTokenExtensions

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

Float

Buy tax measured on a simulated buy alone by the latest decisive contract analysis, as a fraction (0.05 means 5%). Pool, hook and launchpad platform fees are not included. Can be newer than verdict, which updates on the next assessment. Null when no decisive analysis could measure the buy on its own; null is not 0%. A Token-2022 fee as configured is in extensions.token2022.transferFeeConfig.

Float

Sell tax measured on a simulated sell alone by the latest decisive contract analysis, as a fraction (0.05 means 5%). Pool, hook and launchpad platform fees are not included. Can be newer than verdict, which updates on the next assessment. Null when no decisive analysis could measure the sell on its own, including when that analysis found a honeypot: its test sale failed, so no sell tax was measured. Null is not 0%. A Token-2022 fee as configured is in extensions.token2022.transferFeeConfig.

TokenIssuer

The issuer of a real-world-asset token, such as a tokenized stock. Null when the token has no known issuer. See TokenIssuer

Show Properties

String!

Stable identifier for the issuer, e.g. ondo-global-markets. Safe to key on.

String

Human-readable name for the issuer, e.g. Ondo Global Markets. Null if the identifier has no registry entry yet.

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

Used By

Returned by

getTokenBars: Returns aggregated bar chart data to track price changes over time.

API Documentation

Queries

Mutations

Subscriptions

Types

TokenBarsResponse

Used By

​Used By

Used By