Documentation Index
Fetch the complete documentation index at: https://docs.codex.io/llms.txt
Use this file to discover all available pages before exploring further.
Returns
See PairFilterConnection
Show Properties
Show Properties
The list of pairs matching the filter parameters.
See PairFilterResult
Show Properties
Show Properties
The unix timestamp for the creation of the pair.
The unix timestamp for the last transaction to happen on the pair.
The number of buys in the past hour.
The number of buys in the past 4 hours.
The number of buys in the past 12 hours.
The number of buys in the past 24 hours.
Exchange metadata for the pair.
See FilterExchange
Show Properties
Show Properties
The address for the exchange factory contract.
The ID of the exchange (
address:networkId).The name of the exchange.
The version of the exchange. For example,
3 for UniswapV3.The URL for the exchange’s icon.
The network ID the factory is deployed on.
The URL for the exchange’s trading platform.
The highest price in USD in the past hour.
The highest price in USD in the past 4 hours.
The highest price in USD in the past 12 hours.
The highest price in USD in the past 24 hours.
Amount of liquidity in the pair.
The locked liquidity percentage.
The token with higher liquidity in the pair. Can be
token0 or token1.The token of interest. Can be
token0 or token1.The lowest price in USD in the past hour.
The lowest price in USD in the past 4 hours.
The lowest price in USD in the past 12 hours.
The lowest price in USD in the past 24 hours.
The fully diluted market cap.
Metadata for the pair.
See Pair
Show Properties
Show Properties
The contract address of the pair.
The address for the exchange factory contract.
The exchange fee for swaps.
The ID for the pair (
address:networkId).The network ID the pair is deployed on.
The protocol of the pair. E.g. UniswapV4, RaydiumV4, PumpV1, etc.
The amount of required tick separation. Only applicable for pairs on UniswapV3.
The contract address of
token0.The contract address of
token1.The unix timestamp for the creation of the pair.
Metadata for the first token in the pair.
See EnhancedToken
Show Properties
Show Properties
The ID of the token (
address:networkId).The contract address of the token.
The token ID on CoinMarketCap.
The precision to which the token can be divided. For example, the smallest unit for USDC is 0.000001 (6 decimals).
Whether the token has been flagged as a scam.
The token name. For example,
ApeCoin.The network ID the token is deployed on.
The token symbol. For example,
APE.Community gathered links for the socials of this token.
See SocialLinks
More metadata about the token.
See TokenInfo
Show Properties
Show Properties
Uniquely identifies the token.
The contract address of the token.
The circulating supply of the token.
The token ID on CoinMarketCap.
The Grid asset ID, if this token is linked to a Grid asset.
The Grid bluechip rating for this token (e.g.
A+, B-).Whether the token has been flagged as a scam.
The token name. For example,
ApeCoin.The network ID the token is deployed on.
The token symbol. For example,
APE.The total supply of the token.
The thumbhash of the token logo.
The thumbnail token logo URL.
The small token logo URL.
The large token logo URL.
The token banner URL.
The original URL/URI for the video associated with the token.
A description of the token.
The Grid asset ID, if this token is linked to a Grid asset.
The Grid bluechip rating for this token (e.g.
A+, B-).The Grid organization associated with this token.
See Organization
Show Properties
Show Properties
The organization name.
The founding date of the organization.
A short description of the organization.
A detailed description of the organization.
The organization’s tagline.
The type of organization (e.g.
protocol, company).The sector the organization operates in.
URLs associated with the organization.
See OrganizationUrl
Social links for the organization.
See OrganizationSocial
The organization’s logo URL.
The organization’s icon URL.
The Grid root ID for the organization.
Assets managed by this organization.
See Asset
Show Properties
Show Properties
The Grid asset ID.
The asset name.
A description of the asset.
The asset ticker symbol.
The asset type (e.g.
token, stablecoin).The asset status.
The asset icon URL.
The Grid root ID for the parent organization.
Deployments of this asset across chains.
See AssetDeployment
Show Properties
Show Properties
The deployment ID.
The network ID the asset is deployed on.
The contract address of the deployment.
The token standard (e.g.
ERC20, SPL).The Grid asset ID.
The Grid root ID for the parent organization.
The enhanced token this deployment represents.
See EnhancedToken
The Grid asset associated with this token.
See Asset
Show Properties
Show Properties
The Grid asset ID.
The asset name.
A description of the asset.
The asset ticker symbol.
The asset type (e.g.
token, stablecoin).The asset status.
The asset icon URL.
The Grid root ID for the parent organization.
Deployments of this asset across chains.
See AssetDeployment
Show Properties
Show Properties
The deployment ID.
The network ID the asset is deployed on.
The contract address of the deployment.
The token standard (e.g.
ERC20, SPL).The Grid asset ID.
The Grid root ID for the parent organization.
The enhanced token this deployment represents.
See EnhancedToken
A list of exchanges where the token has been traded.
See Exchange
Show Properties
Show Properties
The ID of the exchange (
address:id).The contract address of the exchange.
The hex string for the exchange color.
The name of the exchange.
The version of the exchange, if applicable.
The exchange logo URL.
The network ID the exchange is deployed on.
The URL for the exchange.
The token creator’s wallet address.
The block height the token was created at.
The transaction hash of the token’s creation.
The unix timestamp for the creation of the token.
Returns mint authority address if token is mintable. If null, verify against isMintableValid.
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
Show Properties
Show Properties
The name of the launchpad.
The percentage of the pool that was sold to the public.
The address of the pool.
The unix timestamp when the launchpad was completed.
Indicates if the launchpad is completed.
The slot number when the launchpad was completed.
The slot number when the launchpad was migrated.
The unix timestamp when the launchpad was migrated.
Indicates if the launchpad was migrated.
The pool address after the launchpad was migrated.
The launchpad protocol.
The icon URL of the launchpad.
Whether cashback is enabled for this launchpad token (Pump V1/V2 only).
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.
The name of the launchpad.
This field is deprecated. Use launchpadName instead
The percentage of total supply held by the top 10 holders (excluding exchanges/pairs).
Whether the token name or symbol contains profanity.
All-time high and low price/market cap data for the token.
See TokenExtrema
Show Properties
Show Properties
The token ID (
address:networkId).The contract address of the token.
The network ID the token is deployed on.
The all-time high price in USD.
The unix timestamp when the all-time high price was reached.
The all-time low price in USD.
The unix timestamp when the all-time low price was reached.
The all-time high fully diluted market cap.
The unix timestamp when the all-time high FDV was reached.
The all-time low fully diluted market cap.
The unix timestamp when the all-time low FDV was reached.
The all-time high circulating market cap.
The unix timestamp when the all-time high circulating market cap was reached.
The all-time low circulating market cap.
The unix timestamp when the all-time low circulating market cap was reached.
The Coin Community data for the token
See CoinCommunity
The total supply of the token.
This field is deprecated. Use the TokenInfo type
Information about the token from 3rd party sources.
See ExplorerTokenData
This field is deprecated. Use the TokenInfo type
Show Properties
Show Properties
The ID of the token (
address:networkId).Whether the token has been verified on CoinGecko.
A description of the token.
The precision to which the token can be divided.
The token price in USD.
The token type.
The thumbnail token logo URL.
This field is deprecated. Use the TokenInfo type
The small token logo URL.
This field is deprecated. Use the TokenInfo type
The large token logo URL.
This field is deprecated. Use the TokenInfo type
The circulating supply of the token.
This field is deprecated. Use the TokenInfo type
The amount of this token in the pair.
This field is deprecated. Pooled can be found on the pair instead
Metadata for the second token in the pair.
See EnhancedToken
Show Properties
Show Properties
The ID of the token (
address:networkId).The contract address of the token.
The token ID on CoinMarketCap.
The precision to which the token can be divided. For example, the smallest unit for USDC is 0.000001 (6 decimals).
Whether the token has been flagged as a scam.
The token name. For example,
ApeCoin.The network ID the token is deployed on.
The token symbol. For example,
APE.Community gathered links for the socials of this token.
See SocialLinks
More metadata about the token.
See TokenInfo
Show Properties
Show Properties
Uniquely identifies the token.
The contract address of the token.
The circulating supply of the token.
The token ID on CoinMarketCap.
The Grid asset ID, if this token is linked to a Grid asset.
The Grid bluechip rating for this token (e.g.
A+, B-).Whether the token has been flagged as a scam.
The token name. For example,
ApeCoin.The network ID the token is deployed on.
The token symbol. For example,
APE.The total supply of the token.
The thumbhash of the token logo.
The thumbnail token logo URL.
The small token logo URL.
The large token logo URL.
The token banner URL.
The original URL/URI for the video associated with the token.
A description of the token.
The Grid asset ID, if this token is linked to a Grid asset.
The Grid bluechip rating for this token (e.g.
A+, B-).The Grid organization associated with this token.
See Organization
Show Properties
Show Properties
The organization name.
The founding date of the organization.
A short description of the organization.
A detailed description of the organization.
The organization’s tagline.
The type of organization (e.g.
protocol, company).The sector the organization operates in.
URLs associated with the organization.
See OrganizationUrl
Social links for the organization.
See OrganizationSocial
The organization’s logo URL.
The organization’s icon URL.
The Grid root ID for the organization.
Assets managed by this organization.
See Asset
Show Properties
Show Properties
The Grid asset ID.
The asset name.
A description of the asset.
The asset ticker symbol.
The asset type (e.g.
token, stablecoin).The asset status.
The asset icon URL.
The Grid root ID for the parent organization.
Deployments of this asset across chains.
See AssetDeployment
Show Properties
Show Properties
The deployment ID.
The network ID the asset is deployed on.
The contract address of the deployment.
The token standard (e.g.
ERC20, SPL).The Grid asset ID.
The Grid root ID for the parent organization.
The enhanced token this deployment represents.
See EnhancedToken
The Grid asset associated with this token.
See Asset
Show Properties
Show Properties
The Grid asset ID.
The asset name.
A description of the asset.
The asset ticker symbol.
The asset type (e.g.
token, stablecoin).The asset status.
The asset icon URL.
The Grid root ID for the parent organization.
Deployments of this asset across chains.
See AssetDeployment
Show Properties
Show Properties
The deployment ID.
The network ID the asset is deployed on.
The contract address of the deployment.
The token standard (e.g.
ERC20, SPL).The Grid asset ID.
The Grid root ID for the parent organization.
The enhanced token this deployment represents.
See EnhancedToken
A list of exchanges where the token has been traded.
See Exchange
Show Properties
Show Properties
The ID of the exchange (
address:id).The contract address of the exchange.
The hex string for the exchange color.
The name of the exchange.
The version of the exchange, if applicable.
The exchange logo URL.
The network ID the exchange is deployed on.
The URL for the exchange.
The token creator’s wallet address.
The block height the token was created at.
The transaction hash of the token’s creation.
The unix timestamp for the creation of the token.
Returns mint authority address if token is mintable. If null, verify against isMintableValid.
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
Show Properties
Show Properties
The name of the launchpad.
The percentage of the pool that was sold to the public.
The address of the pool.
The unix timestamp when the launchpad was completed.
Indicates if the launchpad is completed.
The slot number when the launchpad was completed.
The slot number when the launchpad was migrated.
The unix timestamp when the launchpad was migrated.
Indicates if the launchpad was migrated.
The pool address after the launchpad was migrated.
The launchpad protocol.
The icon URL of the launchpad.
Whether cashback is enabled for this launchpad token (Pump V1/V2 only).
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.
The name of the launchpad.
This field is deprecated. Use launchpadName instead
The percentage of total supply held by the top 10 holders (excluding exchanges/pairs).
Whether the token name or symbol contains profanity.
All-time high and low price/market cap data for the token.
See TokenExtrema
Show Properties
Show Properties
The token ID (
address:networkId).The contract address of the token.
The network ID the token is deployed on.
The all-time high price in USD.
The unix timestamp when the all-time high price was reached.
The all-time low price in USD.
The unix timestamp when the all-time low price was reached.
The all-time high fully diluted market cap.
The unix timestamp when the all-time high FDV was reached.
The all-time low fully diluted market cap.
The unix timestamp when the all-time low FDV was reached.
The all-time high circulating market cap.
The unix timestamp when the all-time high circulating market cap was reached.
The all-time low circulating market cap.
The unix timestamp when the all-time low circulating market cap was reached.
The Coin Community data for the token
See CoinCommunity
The total supply of the token.
This field is deprecated. Use the TokenInfo type
Information about the token from 3rd party sources.
See ExplorerTokenData
This field is deprecated. Use the TokenInfo type
Show Properties
Show Properties
The ID of the token (
address:networkId).Whether the token has been verified on CoinGecko.
A description of the token.
The precision to which the token can be divided.
The token price in USD.
The token type.
The thumbnail token logo URL.
This field is deprecated. Use the TokenInfo type
The small token logo URL.
This field is deprecated. Use the TokenInfo type
The large token logo URL.
This field is deprecated. Use the TokenInfo type
The circulating supply of the token.
This field is deprecated. Use the TokenInfo type
The amount of this token in the pair.
This field is deprecated. Pooled can be found on the pair instead
The pooled amounts of each token in the pair.
See PooledTokenValues
The virtual pooled amounts of each token in the pair.
See PooledTokenValues
Custom data for the pair, only certain protocols have this. (uniswapv4, arenatrade for example)
See ProtocolData
Show Properties
Show Properties
See UniswapV4Data
Show Properties
Show Properties
The address of the hook contract for Uniswap V4 pools.
Whether the token is the network token for the Uniswap V4 pool.
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.
See ArenaTradeData
The per-protocol data for the pair, if applicable
See PairProtocolCustomData
This field is deprecated. Use protocolData instead
Show Properties
Show Properties
The address of the hook contract for Uniswap V4 pools.
The token price in USD.
10^n, where n is the number of decimal places the price has. Max 16. Used for TradingView settings.
The percent price change in the past hour. Decimal format.
The percent price change in the past 4 hours. Decimal format.
The percent price change in the past 12 hours. Decimal format.
The percent price change in the past 24 hours. Decimal format.
The percent volume change in the past hour. Decimal format.
The percent volume change in the past 4 hours. Decimal format.
The percent volume change in the past 12 hours. Decimal format.
The percent volume change in the past 24 hours. Decimal format.
The number of sells in the past hour.
The number of sells in the past 4 hours.
The number of sells in the past 12 hours.
The number of sells in the past 24 hours.
Metadata for the first token in the pair.
See EnhancedToken
Show Properties
Show Properties
The ID of the token (
address:networkId).The contract address of the token.
The token ID on CoinMarketCap.
The precision to which the token can be divided. For example, the smallest unit for USDC is 0.000001 (6 decimals).
Whether the token has been flagged as a scam.
The token name. For example,
ApeCoin.The network ID the token is deployed on.
The token symbol. For example,
APE.Community gathered links for the socials of this token.
See SocialLinks
More metadata about the token.
See TokenInfo
Show Properties
Show Properties
Uniquely identifies the token.
The contract address of the token.
The circulating supply of the token.
The token ID on CoinMarketCap.
The Grid asset ID, if this token is linked to a Grid asset.
The Grid bluechip rating for this token (e.g.
A+, B-).Whether the token has been flagged as a scam.
The token name. For example,
ApeCoin.The network ID the token is deployed on.
The token symbol. For example,
APE.The total supply of the token.
The thumbhash of the token logo.
The thumbnail token logo URL.
The small token logo URL.
The large token logo URL.
The token banner URL.
The original URL/URI for the video associated with the token.
A description of the token.
The Grid asset ID, if this token is linked to a Grid asset.
The Grid bluechip rating for this token (e.g.
A+, B-).The Grid organization associated with this token.
See Organization
Show Properties
Show Properties
The organization name.
The founding date of the organization.
A short description of the organization.
A detailed description of the organization.
The organization’s tagline.
The type of organization (e.g.
protocol, company).The sector the organization operates in.
URLs associated with the organization.
See OrganizationUrl
Social links for the organization.
See OrganizationSocial
The organization’s logo URL.
The organization’s icon URL.
The Grid root ID for the organization.
Assets managed by this organization.
See Asset
Show Properties
Show Properties
The Grid asset ID.
The asset name.
A description of the asset.
The asset ticker symbol.
The asset type (e.g.
token, stablecoin).The asset status.
The asset icon URL.
The Grid root ID for the parent organization.
Deployments of this asset across chains.
See AssetDeployment
Show Properties
Show Properties
The deployment ID.
The network ID the asset is deployed on.
The contract address of the deployment.
The token standard (e.g.
ERC20, SPL).The Grid asset ID.
The Grid root ID for the parent organization.
The enhanced token this deployment represents.
See EnhancedToken
The Grid asset associated with this token.
See Asset
Show Properties
Show Properties
The Grid asset ID.
The asset name.
A description of the asset.
The asset ticker symbol.
The asset type (e.g.
token, stablecoin).The asset status.
The asset icon URL.
The Grid root ID for the parent organization.
Deployments of this asset across chains.
See AssetDeployment
Show Properties
Show Properties
The deployment ID.
The network ID the asset is deployed on.
The contract address of the deployment.
The token standard (e.g.
ERC20, SPL).The Grid asset ID.
The Grid root ID for the parent organization.
The enhanced token this deployment represents.
See EnhancedToken
A list of exchanges where the token has been traded.
See Exchange
Show Properties
Show Properties
The ID of the exchange (
address:id).The contract address of the exchange.
The hex string for the exchange color.
The name of the exchange.
The version of the exchange, if applicable.
The exchange logo URL.
The network ID the exchange is deployed on.
The URL for the exchange.
The token creator’s wallet address.
The block height the token was created at.
The transaction hash of the token’s creation.
The unix timestamp for the creation of the token.
Returns mint authority address if token is mintable. If null, verify against isMintableValid.
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
Show Properties
Show Properties
The name of the launchpad.
The percentage of the pool that was sold to the public.
The address of the pool.
The unix timestamp when the launchpad was completed.
Indicates if the launchpad is completed.
The slot number when the launchpad was completed.
The slot number when the launchpad was migrated.
The unix timestamp when the launchpad was migrated.
Indicates if the launchpad was migrated.
The pool address after the launchpad was migrated.
The launchpad protocol.
The icon URL of the launchpad.
Whether cashback is enabled for this launchpad token (Pump V1/V2 only).
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.
The name of the launchpad.
This field is deprecated. Use launchpadName instead
The percentage of total supply held by the top 10 holders (excluding exchanges/pairs).
Whether the token name or symbol contains profanity.
All-time high and low price/market cap data for the token.
See TokenExtrema
Show Properties
Show Properties
The token ID (
address:networkId).The contract address of the token.
The network ID the token is deployed on.
The all-time high price in USD.
The unix timestamp when the all-time high price was reached.
The all-time low price in USD.
The unix timestamp when the all-time low price was reached.
The all-time high fully diluted market cap.
The unix timestamp when the all-time high FDV was reached.
The all-time low fully diluted market cap.
The unix timestamp when the all-time low FDV was reached.
The all-time high circulating market cap.
The unix timestamp when the all-time high circulating market cap was reached.
The all-time low circulating market cap.
The unix timestamp when the all-time low circulating market cap was reached.
The Coin Community data for the token
See CoinCommunity
The total supply of the token.
This field is deprecated. Use the TokenInfo type
Information about the token from 3rd party sources.
See ExplorerTokenData
This field is deprecated. Use the TokenInfo type
Show Properties
Show Properties
The ID of the token (
address:networkId).Whether the token has been verified on CoinGecko.
A description of the token.
The precision to which the token can be divided.
The token price in USD.
The token type.
The thumbnail token logo URL.
This field is deprecated. Use the TokenInfo type
The small token logo URL.
This field is deprecated. Use the TokenInfo type
The large token logo URL.
This field is deprecated. Use the TokenInfo type
The circulating supply of the token.
This field is deprecated. Use the TokenInfo type
The amount of this token in the pair.
This field is deprecated. Pooled can be found on the pair instead
Metadata for the second token in the pair.
See EnhancedToken
Show Properties
Show Properties
The ID of the token (
address:networkId).The contract address of the token.
The token ID on CoinMarketCap.
The precision to which the token can be divided. For example, the smallest unit for USDC is 0.000001 (6 decimals).
Whether the token has been flagged as a scam.
The token name. For example,
ApeCoin.The network ID the token is deployed on.
The token symbol. For example,
APE.Community gathered links for the socials of this token.
See SocialLinks
More metadata about the token.
See TokenInfo
Show Properties
Show Properties
Uniquely identifies the token.
The contract address of the token.
The circulating supply of the token.
The token ID on CoinMarketCap.
The Grid asset ID, if this token is linked to a Grid asset.
The Grid bluechip rating for this token (e.g.
A+, B-).Whether the token has been flagged as a scam.
The token name. For example,
ApeCoin.The network ID the token is deployed on.
The token symbol. For example,
APE.The total supply of the token.
The thumbhash of the token logo.
The thumbnail token logo URL.
The small token logo URL.
The large token logo URL.
The token banner URL.
The original URL/URI for the video associated with the token.
A description of the token.
The Grid asset ID, if this token is linked to a Grid asset.
The Grid bluechip rating for this token (e.g.
A+, B-).The Grid organization associated with this token.
See Organization
Show Properties
Show Properties
The organization name.
The founding date of the organization.
A short description of the organization.
A detailed description of the organization.
The organization’s tagline.
The type of organization (e.g.
protocol, company).The sector the organization operates in.
URLs associated with the organization.
See OrganizationUrl
Social links for the organization.
See OrganizationSocial
The organization’s logo URL.
The organization’s icon URL.
The Grid root ID for the organization.
Assets managed by this organization.
See Asset
Show Properties
Show Properties
The Grid asset ID.
The asset name.
A description of the asset.
The asset ticker symbol.
The asset type (e.g.
token, stablecoin).The asset status.
The asset icon URL.
The Grid root ID for the parent organization.
Deployments of this asset across chains.
See AssetDeployment
Show Properties
Show Properties
The deployment ID.
The network ID the asset is deployed on.
The contract address of the deployment.
The token standard (e.g.
ERC20, SPL).The Grid asset ID.
The Grid root ID for the parent organization.
The enhanced token this deployment represents.
See EnhancedToken
The Grid asset associated with this token.
See Asset
Show Properties
Show Properties
The Grid asset ID.
The asset name.
A description of the asset.
The asset ticker symbol.
The asset type (e.g.
token, stablecoin).The asset status.
The asset icon URL.
The Grid root ID for the parent organization.
Deployments of this asset across chains.
See AssetDeployment
Show Properties
Show Properties
The deployment ID.
The network ID the asset is deployed on.
The contract address of the deployment.
The token standard (e.g.
ERC20, SPL).The Grid asset ID.
The Grid root ID for the parent organization.
The enhanced token this deployment represents.
See EnhancedToken
A list of exchanges where the token has been traded.
See Exchange
Show Properties
Show Properties
The ID of the exchange (
address:id).The contract address of the exchange.
The hex string for the exchange color.
The name of the exchange.
The version of the exchange, if applicable.
The exchange logo URL.
The network ID the exchange is deployed on.
The URL for the exchange.
The token creator’s wallet address.
The block height the token was created at.
The transaction hash of the token’s creation.
The unix timestamp for the creation of the token.
Returns mint authority address if token is mintable. If null, verify against isMintableValid.
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
Show Properties
Show Properties
The name of the launchpad.
The percentage of the pool that was sold to the public.
The address of the pool.
The unix timestamp when the launchpad was completed.
Indicates if the launchpad is completed.
The slot number when the launchpad was completed.
The slot number when the launchpad was migrated.
The unix timestamp when the launchpad was migrated.
Indicates if the launchpad was migrated.
The pool address after the launchpad was migrated.
The launchpad protocol.
The icon URL of the launchpad.
Whether cashback is enabled for this launchpad token (Pump V1/V2 only).
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.
The name of the launchpad.
This field is deprecated. Use launchpadName instead
The percentage of total supply held by the top 10 holders (excluding exchanges/pairs).
Whether the token name or symbol contains profanity.
All-time high and low price/market cap data for the token.
See TokenExtrema
Show Properties
Show Properties
The token ID (
address:networkId).The contract address of the token.
The network ID the token is deployed on.
The all-time high price in USD.
The unix timestamp when the all-time high price was reached.
The all-time low price in USD.
The unix timestamp when the all-time low price was reached.
The all-time high fully diluted market cap.
The unix timestamp when the all-time high FDV was reached.
The all-time low fully diluted market cap.
The unix timestamp when the all-time low FDV was reached.
The all-time high circulating market cap.
The unix timestamp when the all-time high circulating market cap was reached.
The all-time low circulating market cap.
The unix timestamp when the all-time low circulating market cap was reached.
The Coin Community data for the token
See CoinCommunity
The total supply of the token.
This field is deprecated. Use the TokenInfo type
Information about the token from 3rd party sources.
See ExplorerTokenData
This field is deprecated. Use the TokenInfo type
Show Properties
Show Properties
The ID of the token (
address:networkId).Whether the token has been verified on CoinGecko.
A description of the token.
The precision to which the token can be divided.
The token price in USD.
The token type.
The thumbnail token logo URL.
This field is deprecated. Use the TokenInfo type
The small token logo URL.
This field is deprecated. Use the TokenInfo type
The large token logo URL.
This field is deprecated. Use the TokenInfo type
The circulating supply of the token.
This field is deprecated. Use the TokenInfo type
The amount of this token in the pair.
This field is deprecated. Pooled can be found on the pair instead
The number of transactions in the past hour.
The number of transactions in the past 4 hours.
The number of transactions in the past 12 hours.
The number of transactions in the past 24 hours.
The unique number of buys in the past hour.
The unique number of buys in the past 4 hours.
The unique number of buys in the past 12 hours.
The unique number of buys in the past 24 hours.
The unique number of sells in the past hour.
The unique number of sells in the past 4 hours.
The unique number of sells in the past 12 hours.
The unique number of sells in the past 24 hours.
The unique number of transactions in the past hour.
The unique number of transactions in the past 4 hours.
The unique number of transactions in the past 12 hours.
The unique number of transactions in the past 24 hours.
The trade volume in USD in the past hour.
The trade volume in USD in the past 4 hours.
The trade volume in USD in the past 12 hours.
The trade volume in USD in the past 24 hours.
The buy volume in USD in the past hour.
The buy volume in USD in the past 12 hours.
The buy volume in USD in the past 24 hours.
The buy volume in USD in the past 4 hours.
The sell volume in USD in the past hour.
The sell volume in USD in the past 12 hours.
The sell volume in USD in the past 24 hours.
The sell volume in USD in the past 4 hours.
The average age of the wallets that traded in the last 24h
The standard deviation of age of the wallets that traded in the last 24h
The percentage of wallets that are less than 1d old that have traded in the last 24h
The percentage of wallets that are less than 7d old that have traded in the last 24h
The reasons the token has been flagged as a potential scam.
See PotentialScamReason
Show Properties
Show Properties
The number of pairs returned.
Where in the list the server started when returning items.
Arguments
A set of filters to apply.
See PairFilters
Show Properties
Show Properties
The unix timestamp for the creation of the pair.
See NumberFilter
The unix timestamp for the last transaction to happen on the pair.
See NumberFilter
The number of buys in the past hour.
See NumberFilter
The number of buys in the past 12 hours.
See NumberFilter
The number of buys in the past 24 hours.
See NumberFilter
The number of buys in the past 4 hours.
See NumberFilter
The list of exchange contract addresses to filter by.
The highest price in USD in the past hour.
See NumberFilter
The highest price in USD in the past 12 hours.
See NumberFilter
The highest price in USD in the past 24 hours.
See NumberFilter
The highest price in USD in the past 4 hours.
See NumberFilter
The amount of liquidity in the pair.
See NumberFilter
The percent amount of liquidity that is locked
See NumberFilter
The lowest price in USD in the past hour.
See NumberFilter
The lowest price in USD in the past 12 hours.
See NumberFilter
The lowest price in USD in the past 24 hours.
See NumberFilter
The lowest price in USD in the past 4 hours.
See NumberFilter
The list of network IDs to filter by.
The token price in USD.
See NumberFilter
The percent price change in the past hour. Decimal format.
See NumberFilter
The percent price change in the past 12 hours. Decimal format.
See NumberFilter
The percent price change in the past 24 hours. Decimal format.
See NumberFilter
The percent price change in the past 4 hours. Decimal format.
See NumberFilter
The percent volume change in the past hour. Decimal format.
See NumberFilter
The percent volume change in the past 4 hours. Decimal format.
See NumberFilter
The percent volume change in the past 12 hours. Decimal format.
See NumberFilter
The percent volume change in the past 24 hours. Decimal format.
See NumberFilter
The number of sells in the past hour.
See NumberFilter
The number of sells in the past 12 hours.
See NumberFilter
The number of sells in the past 24 hours.
See NumberFilter
The number of sells in the past 4 hours.
See NumberFilter
The list of token contract addresses to filter by.
The number of transactions in the past hour.
See NumberFilter
The number of transactions in the past 12 hours.
See NumberFilter
The number of transactions in the past 24 hours.
See NumberFilter
The number of transactions in the past 4 hours.
See NumberFilter
The unique number of buys in the past hour.
See NumberFilter
The unique number of buys in the past 12 hours.
See NumberFilter
The unique number of buys in the past 24 hours.
See NumberFilter
The unique number of buys in the past 4 hours.
See NumberFilter
The unique number of sells in the past hour.
See NumberFilter
The unique number of sells in the past 12 hours.
See NumberFilter
The unique number of sells in the past 24 hours.
See NumberFilter
The unique number of sells in the past 4 hours.
See NumberFilter
The unique number of transactions in the past hour.
See NumberFilter
The unique number of transactions in the past 12 hours.
See NumberFilter
The unique number of transactions in the past 24 hours.
See NumberFilter
The unique number of transactions in the past 4 hours.
See NumberFilter
The trade volume in USD in the past hour.
See NumberFilter
The trade volume in USD in the past 12 hours.
See NumberFilter
The trade volume in USD in the past 24 hours.
See NumberFilter
The trade volume in USD in the past 4 hours.
See NumberFilter
The buy volume in USD in the past hour.
See NumberFilter
The buy volume in USD in the past 12 hours.
See NumberFilter
The buy volume in USD in the past 24 hours.
See NumberFilter
The buy volume in USD in the past 4 hours.
See NumberFilter
The sell volume in USD in the past hour.
See NumberFilter
The sell volume in USD in the past 12 hours.
See NumberFilter
The sell volume in USD in the past 24 hours.
See NumberFilter
The sell volume in USD in the past 4 hours.
See NumberFilter
Filter potential Scams
Whether to ignore pairs/tokens not relevant to trending
Whether to filter for pairs on testnet networks. Use
true for testnet pairs only, false for mainnet pairs only and undefined (default) for both.The address of the hook contract for applicable protocols.
The average age of the wallets that traded in the last 24h
See NumberFilter
The standard deviation of age of the wallets that traded in the last 24h
See NumberFilter
The percentage of wallets that are less than 1d old that have traded in the last 24h
See NumberFilter
The type of statistics returned. Can be
FILTERED or UNFILTERED. Default is UNFILTERED.
See TokenPairStatisticsTypeA phrase to search for. Can match a token or pair contract address or ID (
address:networkId), or partially match a token name or symbol.A list of pair or token contract addresses or IDs (
address:networkId) to filter by.A set of token contract addresses that make up a pair. Can be used in place of a pair contract address.
See PairFilterMatchTokens
A list of ranking attributes to apply.
See PairRanking
Show Properties
Show Properties
The attribute to rank pairs by.
See PairRankingAttribute
Show Properties
Show Properties
The direction to apply to the ranking attribute.
See RankingDirection
The maximum number of pairs to return.
Where in the list the server should start when returning items. Use
count+offset from the previous query to request the next page of results.Example
Test this query in the Explorer →{
filterPairs(
filters: {network: 1399811149}
phrase: "PUMP"
limit: 10
) {
results {
buyCount12
highPrice24
liquidity
lowPrice24
marketCap
price
priceChange24
volumeUSD24
pair {
token0Data {
address
name
symbol
}
token1Data {
address
name
symbol
}
}
}
}
}
Usage Guidelines
- Response limit: 200 pairs per request
- Use
phraseparameter for searching by token name, symbol, or pair address - Apply quality filters such as volume and liquidity minimums to avoid low quality pairs
- Results include pre-computed stats like
priceChange24,volumeUSD24,buyCount12, etc. for easy display
Troubleshooting Tips
When should I use filterPairs vs filterTokens?
When should I use filterPairs vs filterTokens?
Use
filterPairs when you want to discover or search trading pairs and need pair-specific data like which tokens are paired together. Use filterTokens when you want to discover tokens and need token-level aggregate data across all their pairs.How do I get the token I care about from pair results?
How do I get the token I care about from pair results?
Each pair has
token0Data and token1Data. One will be your target token, the other is typically a quote token (like USDC, WETH, or SOL). Check the address field to identify which is which, or filter by a known quote token address.Results are returning too many low-quality pairs
Results are returning too many low-quality pairs
Add quality filters to improve results. Set minimum thresholds for
liquidity and volumeUSD24 to filter out inactive or low-liquidity pairs.How do I filter pairs for a specific token?
How do I filter pairs for a specific token?
Use the
token0 or token1 filter with the token address, or use phrase to search by token name/symbol. You can also filter by network to narrow results to a specific chain.Can I fetch pair metadata for multiple pool addresses?
Can I fetch pair metadata for multiple pool addresses?
Yes — use
filterPairs for this. It accepts pool addresses via the phrase parameter or filters and returns metadata for many pairs in a single call.How do I find the pool with the highest liquidity for a token?
How do I find the pool with the highest liquidity for a token?
Use The
filterPairs with a phrase containing the token’s address (formatted as address:networkId) and rank by liquidity descending:filterPairs(
phrase: "0x6982508145454ce325ddbe47a25d4ec3d2311933:1"
rankings: { attribute: liquidity, direction: DESC }
)
liquidity value represents the USD value of the base token (e.g. ETH or a stablecoin) backing the pair. Price change metrics across multiple timeframes are available on both filterPairs and filterTokens.How does `phrase` search work for pairs?
How does `phrase` search work for pairs?
phrase matches pair addresses or the symbols/names of the tokens in the pair. As with filterTokens, avoid sorting by createdAt for phrase searches — use liquidity, volumeUSD24, or trendingScore24 for more meaningful rankings. See filterTokens — How does phrase search work? for the same gotcha at the token level.Related Recipes
- Discover Tokens: Build token discovery pages with trending data, filters, and search