String!
The contract address of the pair.
String!
The address for the exchange factory contract.
Int
The exchange fee for swaps.
String!
The ID for the pair (
address:networkId).Int!
The network ID the pair is deployed on.
String
The protocol of the pair. E.g. UniswapV4, RaydiumV4, PumpV1, etc.
Int
The amount of required tick separation. Only applicable for pairs on UniswapV3.
String!
The contract address of
token0.String!
The contract address of
token1.Int
The unix timestamp for the creation of the pair.
EnhancedToken
Metadata for the first token in the pair.
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
TokenInfo
More metadata about the token.
See TokenInfo
Show Properties
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 OrganizationShow Properties
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
The Grid asset associated with this token. Null when the token is reached through
AssetDeployment.token.
See AssetShow Properties
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
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
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
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
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
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
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 XStockTokenExtensionsErc7572CustomInfo
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[Category!]
See Category
Show Properties
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 TokenRiskShow Properties
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
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
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
EnhancedToken
Metadata for the second token in the pair.
See EnhancedToken
PooledTokenValues
The pooled amounts of each token in the pair.
See PooledTokenValues
PooledTokenValues
The virtual pooled amounts of each token in the pair.
See PooledTokenValues
CurrencyUnits
The measurement units of this pool’s raw side amounts and reserves; null when the pool measures in its tokens’ metadata.
See CurrencyUnits
Show Properties
Show Properties
ProtocolData
union
Custom data for the pair, only certain protocols have this. (uniswapv4, arenatrade for example)
See ProtocolData
Show Properties
Show Properties
UniswapV4Data
See UniswapV4Data
Show Properties
Show Properties
String
The address of the hook contract for Uniswap V4 pools.
Boolean
Whether the token is the network token for the Uniswap V4 pool.
Boolean
Whether the pool uses a dynamic fee. A fee of 0x80000 is used by Uniswap V4 to indicate a dynamic pool — in such cases, the fee percentage on the pair should be disregarded.
CurrencyUnits
The measurement units of the pool’s slots, when they differ from the tokens’ metadata.
See CurrencyUnits
String!
ArenaTradeData
See ArenaTradeData
PairProtocolCustomData
deprecated
The per-protocol data for the pair, if applicable
See PairProtocolCustomData
This field is deprecated. Use protocolData instead
Show Properties
Show Properties
String
The address of the hook contract for Uniswap V4 pools.
Used By
Returned by- categoryTokens: Returns the tokens assigned to a category (including its subcategories), with optional
filterTokens-style filters and rankings applied. - filterPairs: Returns a list of pairs based on a variety of filters.
- filterTokens: Discover, screen, and rank tokens across every supported network using 100+ on-chain signals: trading activity, liquidity, holder behavior, fee economics, and launchpad lifecycle.
- getBars: Returns bar chart data to track price changes over time.
- getDetailedPairsStats: Returns bucketed stats for a given token within a list of pairs.
- getDetailedPairStats: Returns bucketed stats for a given token within a pair.
- listPairsForToken: Returns a list of pairs containing a given token.
- listPairsWithMetadataForToken: Returns a list of pair metadata for a token.
- onFilterTokensUpdated: Live-streamed filter token updates for the current
filterTokensresult set. - pairs: Returns pairs by their IDs (
address:networkId, orpoolId:networkIdfor singleton pools such as Uniswap V4), in request order, withnullfor an ID that is not a known pair. UnlikefilterPairs(pairs:), a token address is never expanded into its top pairs. At most 200 IDs.