[PairFilterResult]
The list of pairs matching the filter parameters.
See PairFilterResult
Show Properties
Show Properties
Int
The unix timestamp for the creation of the pair.
Int
The unix timestamp for the last transaction to happen on the pair.
Int
The number of buys in the past hour.
Int
The number of buys in the past 4 hours.
Int
The number of buys in the past 12 hours.
Int
The number of buys in the past 24 hours.
FilterExchange
Exchange metadata for the pair.
See FilterExchange
Show Properties
Show Properties
String!
The address for the exchange factory contract.
String!
The ID of the exchange (
address:networkId).String
The name of the exchange.
String
The version of the exchange. For example,
3 for UniswapV3.String
The URL for the exchange’s icon.
Int!
The network ID the factory is deployed on.
String
The URL for the exchange’s trading platform.
String
The highest price in USD in the past hour.
String
The highest price in USD in the past 4 hours.
String
The highest price in USD in the past 12 hours.
String
The highest price in USD in the past 24 hours.
String
Amount of liquidity in the pair.
Float!
The locked liquidity percentage.
String
The token with higher liquidity in the pair. Can be
token0 or token1.String
The token of interest. Can be
token0 or token1.String
The lowest price in USD in the past hour.
String
The lowest price in USD in the past 4 hours.
String
The lowest price in USD in the past 12 hours.
String
The lowest price in USD in the past 24 hours.
String
The fully diluted market cap.
Pair
Metadata for the pair.
See Pair
Show Properties
Show Properties
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
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
ProtocolData
Custom data for the pair, only certain protocols have this. (uniswapv4, arenatrade for example)
See ProtocolData
PairProtocolCustomData
deprecated
The per-protocol data for the pair, if applicable
See PairProtocolCustomData
This field is deprecated. Use protocolData instead
String
The token price in USD.
String
10^n, where n is the number of decimal places the price has. Max 16. Used for TradingView settings.
String
The percent price change in the past hour. Decimal format.
String
The percent price change in the past 4 hours. Decimal format.
String
The percent price change in the past 12 hours. Decimal format.
String
The percent price change in the past 24 hours. Decimal format.
String
The percent volume change in the past hour. Decimal format.
String
The percent volume change in the past 4 hours. Decimal format.
String
The percent volume change in the past 12 hours. Decimal format.
String
The percent volume change in the past 24 hours. Decimal format.
Int
The number of sells in the past hour.
Int
The number of sells in the past 4 hours.
Int
The number of sells in the past 12 hours.
Int
The number of sells in the past 24 hours.
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
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. Null when the token is reached through
AssetDeployment.token.
See OrganizationAsset
The Grid asset associated with this token. Null when the token is reached through
AssetDeployment.token.
See AssetString
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
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
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 Erc7572CustomInfoTokenRisk
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 TokenRiskString
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
Int
The number of transactions in the past hour.
Int
The number of transactions in the past 4 hours.
Int
The number of transactions in the past 12 hours.
Int
The number of transactions in the past 24 hours.
Int
The unique number of buys in the past hour.
Int
The unique number of buys in the past 4 hours.
Int
The unique number of buys in the past 12 hours.
Int
The unique number of buys in the past 24 hours.
Int
The unique number of sells in the past hour.
Int
The unique number of sells in the past 4 hours.
Int
The unique number of sells in the past 12 hours.
Int
The unique number of sells in the past 24 hours.
Int
The unique number of transactions in the past hour.
Int
The unique number of transactions in the past 4 hours.
Int
The unique number of transactions in the past 12 hours.
Int
The unique number of transactions in the past 24 hours.
String
The trade volume in USD in the past hour.
String
The trade volume in USD in the past 4 hours.
String
The trade volume in USD in the past 12 hours.
String
The trade volume in USD in the past 24 hours.
String
The buy volume in USD in the past hour.
String
The buy volume in USD in the past 12 hours.
String
The buy volume in USD in the past 24 hours.
String
The buy volume in USD in the past 4 hours.
String
The sell volume in USD in the past hour.
String
The sell volume in USD in the past 12 hours.
String
The sell volume in USD in the past 24 hours.
String
The sell volume in USD in the past 4 hours.
String
The average age of the wallets that traded in the last 24h
String
The standard deviation of age of the wallets that traded in the last 24h
String
The percentage of wallets that are less than 1d old that have traded in the last 24h
String
The percentage of wallets that are less than 7d old that have traded in the last 24h
[PotentialScamReason]
The reasons the token has been flagged as a potential scam.
See PotentialScamReason
Show Properties
Show Properties
enum
The token does not meet the minimum liquidity threshold.
enum
Liquidity could not be read, so the liquidity checks did not run.
enum
The token has experienced a significant drop in liquidity.
enum
The token has suspicious wallet activity.
enum
The token has an abnormal buyer ratio.
enum
The creator wallet holds at least half of the supply.
enum
Wallets that bought within seconds of launch hold at least half of the supply.
enum
The token graduated its launchpad in its creation slot and the launch shape is corroborated by a creator distribution, holders that never traded, bot churn, one-way flow, a thin pool or a bot-only market.
enum
A launchpad token whose market is a pool on a venue the launchpad does not migrate to, opened within minutes of the mint.
enum
Hundreds of buyers, a few dozen sellers doing every sell, buy and sell volume matched, almost nobody holding: supply cycled through hub wallets.
Float
The pool’s static fee rate in basis points (1 bps = 0.01%), normalized across protocols. Null when the pool has no comparable static rate, including when a hook sets the fee per swap.
Boolean
Whether a hook or plugin sets the fee per swap rather than the pool charging a static rate. Null for protocols that do not report it.
RiskVerdict
Codex’s risk verdict for the pair: the token’s verdict, or
SCAM when this pair’s own pool is a proven trap (the pool’s hook refuses or underpays sells the token itself allows). Not a safety guarantee — read riskCoverage first. Null when unassessed.
See RiskVerdictShow Properties
Show Properties
enum
Proven a scam by mechanical evidence, or labelled one by a human.
enum
The weighted score reached the high-risk threshold.
enum
The weighted score reached the caution threshold but remains below high risk.
enum
The weighted score is below the caution threshold. Reasons may still be present. Not a statement that the token is safe.
enum
A human marked this token not-a-scam. A moderator judgement, not an allowlist.
enum
Marked not-a-scam by a human, but mechanical signals disagree.
Float
Weighted risk score from 0 to 100. Null for a terminal verdict reached without scoring, and when unassessed. Not a probability.
Int
Unix seconds when the engine last recorded a change to this token’s risk. Null when the token has never been assessed.
Int
Unix seconds of the contract analysis
riskVerdict rests on: the decisive analysis, or the newest reading of a proven trapped pool. Null when neither stands behind it.RiskAnalysisCoverage
How much contract analysis stood behind
riskVerdict. Describes what was looked at, not what was concluded.
See RiskAnalysisCoverageShow Properties
Show Properties
enum
No contract analysis stands behind this assessment.
enum
Analysis ran but reached no decisive verdict.
enum
Analysis ran and reached a decisive verdict, or proved a pool of the token is a trap.
enum
The verdict rests on a tradeable analysis more than seven days old. A contract can change after it was probed. A honeypot proof never becomes stale.
[RiskReasonCode!]
The reason codes behind
riskVerdict, unordered. New codes are added over time, so do not assume this list is exhaustive.
See RiskReasonCodeShow Properties
Show Properties
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
The creator of a launchpad token sold or handed off a large share of supply in the token’s first hour.
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
enum
Int
The number of pairs returned.
Int
Where in the list the server started when returning items.
Used By
Returned by- filterPairs: Returns a list of pairs based on a variety of filters.