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 DetailedPairStats
Show Properties
Show Properties
The contract address of the pair.
The network ID the pair is deployed on.
The token of interest used to calculate token-specific stats.
See TokenOfInterest
The unix timestamp for the last transaction to happen on the pair.
The type of statistics returned. Can be
FILTERED or UNFILTERED.
See TokenPairStatisticsTypeThe breakdown of stats over a 5 minute window.
See WindowedDetailedPairStats
Show Properties
Show Properties
The unix timestamp for the start of the window.
The unix timestamp for the end of the window.
The list of start/end timestamps broken down for each bucket within the window.
See DetailedPairStatsBucketTimestamp
The currency stats in USD, such as volume.
See WindowedDetailedCurrencyPairStats
Show Properties
Show Properties
The volume over the time frame.
See DetailedPairStatsStringMetrics
The buy volume over the time frame.
See DetailedPairStatsStringMetrics
The sell volume over the time frame.
See DetailedPairStatsStringMetrics
The opening price for the time frame.
See DetailedPairStatsStringMetrics
The highest price in USD in the time frame.
See DetailedPairStatsStringMetrics
The lowest price in USD in the time frame.
See DetailedPairStatsStringMetrics
The closing price forr the time frame.
See DetailedPairStatsStringMetrics
The liquidity for the time frame.
See DetailedPairStatsStringMetrics
The numerical stats, such as number of buyers.
See WindowedDetailedNonCurrencyPairStats
Show Properties
Show Properties
The transaction count over the time frame.
See DetailedPairStatsNumberMetrics
The number of buys over the time frame.
See DetailedPairStatsNumberMetrics
The number of sells over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique traders over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique buyers over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique sellers over the time frame.
See DetailedPairStatsNumberMetrics
The breakdown of stats over a 15 minute window.
See WindowedDetailedPairStats
Show Properties
Show Properties
The unix timestamp for the start of the window.
The unix timestamp for the end of the window.
The list of start/end timestamps broken down for each bucket within the window.
See DetailedPairStatsBucketTimestamp
The currency stats in USD, such as volume.
See WindowedDetailedCurrencyPairStats
Show Properties
Show Properties
The volume over the time frame.
See DetailedPairStatsStringMetrics
The buy volume over the time frame.
See DetailedPairStatsStringMetrics
The sell volume over the time frame.
See DetailedPairStatsStringMetrics
The opening price for the time frame.
See DetailedPairStatsStringMetrics
The highest price in USD in the time frame.
See DetailedPairStatsStringMetrics
The lowest price in USD in the time frame.
See DetailedPairStatsStringMetrics
The closing price forr the time frame.
See DetailedPairStatsStringMetrics
The liquidity for the time frame.
See DetailedPairStatsStringMetrics
The numerical stats, such as number of buyers.
See WindowedDetailedNonCurrencyPairStats
Show Properties
Show Properties
The transaction count over the time frame.
See DetailedPairStatsNumberMetrics
The number of buys over the time frame.
See DetailedPairStatsNumberMetrics
The number of sells over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique traders over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique buyers over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique sellers over the time frame.
See DetailedPairStatsNumberMetrics
The breakdown of stats over an hour window.
See WindowedDetailedPairStats
Show Properties
Show Properties
The unix timestamp for the start of the window.
The unix timestamp for the end of the window.
The list of start/end timestamps broken down for each bucket within the window.
See DetailedPairStatsBucketTimestamp
The currency stats in USD, such as volume.
See WindowedDetailedCurrencyPairStats
Show Properties
Show Properties
The volume over the time frame.
See DetailedPairStatsStringMetrics
The buy volume over the time frame.
See DetailedPairStatsStringMetrics
The sell volume over the time frame.
See DetailedPairStatsStringMetrics
The opening price for the time frame.
See DetailedPairStatsStringMetrics
The highest price in USD in the time frame.
See DetailedPairStatsStringMetrics
The lowest price in USD in the time frame.
See DetailedPairStatsStringMetrics
The closing price forr the time frame.
See DetailedPairStatsStringMetrics
The liquidity for the time frame.
See DetailedPairStatsStringMetrics
The numerical stats, such as number of buyers.
See WindowedDetailedNonCurrencyPairStats
Show Properties
Show Properties
The transaction count over the time frame.
See DetailedPairStatsNumberMetrics
The number of buys over the time frame.
See DetailedPairStatsNumberMetrics
The number of sells over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique traders over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique buyers over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique sellers over the time frame.
See DetailedPairStatsNumberMetrics
The breakdown of stats over a 4 hour window.
See WindowedDetailedPairStats
Show Properties
Show Properties
The unix timestamp for the start of the window.
The unix timestamp for the end of the window.
The list of start/end timestamps broken down for each bucket within the window.
See DetailedPairStatsBucketTimestamp
The currency stats in USD, such as volume.
See WindowedDetailedCurrencyPairStats
Show Properties
Show Properties
The volume over the time frame.
See DetailedPairStatsStringMetrics
The buy volume over the time frame.
See DetailedPairStatsStringMetrics
The sell volume over the time frame.
See DetailedPairStatsStringMetrics
The opening price for the time frame.
See DetailedPairStatsStringMetrics
The highest price in USD in the time frame.
See DetailedPairStatsStringMetrics
The lowest price in USD in the time frame.
See DetailedPairStatsStringMetrics
The closing price forr the time frame.
See DetailedPairStatsStringMetrics
The liquidity for the time frame.
See DetailedPairStatsStringMetrics
The numerical stats, such as number of buyers.
See WindowedDetailedNonCurrencyPairStats
Show Properties
Show Properties
The transaction count over the time frame.
See DetailedPairStatsNumberMetrics
The number of buys over the time frame.
See DetailedPairStatsNumberMetrics
The number of sells over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique traders over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique buyers over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique sellers over the time frame.
See DetailedPairStatsNumberMetrics
The breakdown of stats over a 12 hour window.
See WindowedDetailedPairStats
Show Properties
Show Properties
The unix timestamp for the start of the window.
The unix timestamp for the end of the window.
The list of start/end timestamps broken down for each bucket within the window.
See DetailedPairStatsBucketTimestamp
The currency stats in USD, such as volume.
See WindowedDetailedCurrencyPairStats
Show Properties
Show Properties
The volume over the time frame.
See DetailedPairStatsStringMetrics
The buy volume over the time frame.
See DetailedPairStatsStringMetrics
The sell volume over the time frame.
See DetailedPairStatsStringMetrics
The opening price for the time frame.
See DetailedPairStatsStringMetrics
The highest price in USD in the time frame.
See DetailedPairStatsStringMetrics
The lowest price in USD in the time frame.
See DetailedPairStatsStringMetrics
The closing price forr the time frame.
See DetailedPairStatsStringMetrics
The liquidity for the time frame.
See DetailedPairStatsStringMetrics
The numerical stats, such as number of buyers.
See WindowedDetailedNonCurrencyPairStats
Show Properties
Show Properties
The transaction count over the time frame.
See DetailedPairStatsNumberMetrics
The number of buys over the time frame.
See DetailedPairStatsNumberMetrics
The number of sells over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique traders over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique buyers over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique sellers over the time frame.
See DetailedPairStatsNumberMetrics
The breakdown of stats over a 24 hour window.
See WindowedDetailedPairStats
Show Properties
Show Properties
The unix timestamp for the start of the window.
The unix timestamp for the end of the window.
The list of start/end timestamps broken down for each bucket within the window.
See DetailedPairStatsBucketTimestamp
The currency stats in USD, such as volume.
See WindowedDetailedCurrencyPairStats
Show Properties
Show Properties
The volume over the time frame.
See DetailedPairStatsStringMetrics
The buy volume over the time frame.
See DetailedPairStatsStringMetrics
The sell volume over the time frame.
See DetailedPairStatsStringMetrics
The opening price for the time frame.
See DetailedPairStatsStringMetrics
The highest price in USD in the time frame.
See DetailedPairStatsStringMetrics
The lowest price in USD in the time frame.
See DetailedPairStatsStringMetrics
The closing price forr the time frame.
See DetailedPairStatsStringMetrics
The liquidity for the time frame.
See DetailedPairStatsStringMetrics
The numerical stats, such as number of buyers.
See WindowedDetailedNonCurrencyPairStats
Show Properties
Show Properties
The transaction count over the time frame.
See DetailedPairStatsNumberMetrics
The number of buys over the time frame.
See DetailedPairStatsNumberMetrics
The number of sells over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique traders over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique buyers over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique sellers over the time frame.
See DetailedPairStatsNumberMetrics
The breakdown of stats over a 7 day window.
See WindowedDetailedPairStats
Show Properties
Show Properties
The unix timestamp for the start of the window.
The unix timestamp for the end of the window.
The list of start/end timestamps broken down for each bucket within the window.
See DetailedPairStatsBucketTimestamp
The currency stats in USD, such as volume.
See WindowedDetailedCurrencyPairStats
Show Properties
Show Properties
The volume over the time frame.
See DetailedPairStatsStringMetrics
The buy volume over the time frame.
See DetailedPairStatsStringMetrics
The sell volume over the time frame.
See DetailedPairStatsStringMetrics
The opening price for the time frame.
See DetailedPairStatsStringMetrics
The highest price in USD in the time frame.
See DetailedPairStatsStringMetrics
The lowest price in USD in the time frame.
See DetailedPairStatsStringMetrics
The closing price forr the time frame.
See DetailedPairStatsStringMetrics
The liquidity for the time frame.
See DetailedPairStatsStringMetrics
The numerical stats, such as number of buyers.
See WindowedDetailedNonCurrencyPairStats
Show Properties
Show Properties
The transaction count over the time frame.
See DetailedPairStatsNumberMetrics
The number of buys over the time frame.
See DetailedPairStatsNumberMetrics
The number of sells over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique traders over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique buyers over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique sellers over the time frame.
See DetailedPairStatsNumberMetrics
The breakdown of stats over a 30 day window.
See WindowedDetailedPairStats
Show Properties
Show Properties
The unix timestamp for the start of the window.
The unix timestamp for the end of the window.
The list of start/end timestamps broken down for each bucket within the window.
See DetailedPairStatsBucketTimestamp
The currency stats in USD, such as volume.
See WindowedDetailedCurrencyPairStats
Show Properties
Show Properties
The volume over the time frame.
See DetailedPairStatsStringMetrics
The buy volume over the time frame.
See DetailedPairStatsStringMetrics
The sell volume over the time frame.
See DetailedPairStatsStringMetrics
The opening price for the time frame.
See DetailedPairStatsStringMetrics
The highest price in USD in the time frame.
See DetailedPairStatsStringMetrics
The lowest price in USD in the time frame.
See DetailedPairStatsStringMetrics
The closing price forr the time frame.
See DetailedPairStatsStringMetrics
The liquidity for the time frame.
See DetailedPairStatsStringMetrics
The numerical stats, such as number of buyers.
See WindowedDetailedNonCurrencyPairStats
Show Properties
Show Properties
The transaction count over the time frame.
See DetailedPairStatsNumberMetrics
The number of buys over the time frame.
See DetailedPairStatsNumberMetrics
The number of sells over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique traders over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique buyers over the time frame.
See DetailedPairStatsNumberMetrics
The number of unique sellers over the time frame.
See DetailedPairStatsNumberMetrics
Number of aggregated buckets specified in input
The timestamp specified as input to the query
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.
Arguments
The contract address of the pair.
The network ID the pair is deployed on.
The token of interest used to calculate token-specific stats for the pair. Can be
token0 or token1.
See TokenOfInterestThe unix timestamp for the stats. Defaults to current.
The number of aggregated values to receive. Note: Each duration has predetermined bucket sizes. The first n-1 buckets are historical. The last bucket is a snapshot of current data. duration
day1: 6 buckets (4 hours each) plus 1 partial bucket duration hour12: 12 buckets (1 hour each) plus 1 partial bucket duration hour4: 8 buckets (30 min each) plus 1 partial bucket duration hour1: 12 buckets (5 min each) plus 1 partial bucket duration min5: 5 buckets (1 min each) plus 1 partial bucket For example, requesting 11 buckets for a min5 duration will return the last 10 minutes worth of data plus a snapshot for the current minute.The type of statistics returned. Can be
FILTERED or UNFILTERED. Default is UNFILTERED.
See TokenPairStatisticsTypeExample
Test this query in the Explorer →{
getDetailedPairStats(
pairAddress: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640"
networkId: 1
tokenOfInterest: token0
durations: [min5, hour1, hour4, hour12, day1]
) {
pairAddress
networkId
tokenOfInterest
statsType
lastTransaction
pair {
token0
token1
token0Data {
address
name
symbol
}
token1Data {
address
name
symbol
}
}
stats_hour1 {
statsUsd {
volume {
currentValue
previousValue
change
}
buyVolume {
currentValue
previousValue
change
}
sellVolume {
currentValue
previousValue
change
}
}
statsNonCurrency {
transactions {
currentValue
previousValue
change
}
buyers {
currentValue
previousValue
change
}
sellers {
currentValue
previousValue
change
}
}
}
}
}
Usage Guidelines
- Query using
pairAddressandnetworkId(not the combined pair ID format) - Use
tokenOfInterest(token0ortoken1) to specify which token’s perspective to use for buy/sell calculations - Use
durationsarray to request specific time windows:min5,min15,hour1,hour4,hour12,day1,week1,day30 - Stats are returned in separate fields like
stats_hour1,stats_day1, etc. based on requested durations statsUsdcontains USD-denominated metrics (volume, buyVolume, sellVolume)statsNonCurrencycontains count metrics (transactions, buyers, sellers, buys, sells)- Each metric includes
currentValue,previousValue, andchange(percent change in decimal format) - Use
bucketsarray within each metric for granular time-series data
Troubleshooting Tips
What does tokenOfInterest affect?
What does tokenOfInterest affect?
tokenOfInterest determines the perspective for buy/sell classification. If set to token1, a “buy” means buying token1 (selling token0), and vice versa. This affects buyVolume, sellVolume, buyers, and sellers metrics.What's the difference between FILTERED and UNFILTERED statsType?
What's the difference between FILTERED and UNFILTERED statsType?
FILTERED stats exclude suspected bot/MEV activity to show organic trading. UNFILTERED includes all transactions. Use statsType in the response to see which type was returned.How do I use the buckets array?
How do I use the buckets array?
Each metric includes a
buckets array with values for sub-intervals within the duration. For example, stats_hour1 might have 12 buckets of 5 minutes each. Use the timestamps array to map bucket indices to time ranges.Why is change showing as null?
Why is change showing as null?
The
change field requires both currentValue and previousValue to calculate. For very new pairs or time windows with no previous data, change may be null.How do I get historical stats?
How do I get historical stats?
Use the
timestamp parameter to query stats as of a specific point in time. By default, stats are returned for the current time.How do I obtain historical liquidity data, token prices, and volumes for a pool?
How do I obtain historical liquidity data, token prices, and volumes for a pool?
getDetailedPairStats is the most accurate source of historical pool stats — pass the pairAddress, networkId, and the durations you need (min5, hour1, day1, etc.). getBars is also useful for OHLCV-style time series. Note that getTokenPrices returns a weighted price across all of a token’s pools — individual pool prices can differ.Related Recipes
- Discover Tokens: Build token discovery pages with trending data, filters, and search