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.
onFilterTokensUpdated is the live counterpart to filterTokens. It accepts the same filter and ranking inputs, sends the current matching set on the first message, then re-evaluates every 30 seconds and pushes updates as the matching set changes. Use it anywhere you would otherwise re-run filterTokens on a timer.
Boolean filtering: The
filters input supports an optional boolFilter field that accepts and, or, and not operators (nestable up to 4 levels). Use it when you need different filter conditions for a subsets of tokens, such as per-network thresholds, or across different fields. For example, you might want different filter conditions depending on whether tokens are on Solana or Base. See Advanced Filtering for details.This endpoint requires a Growth or Enterprise plan. Learn more.
Returns
See FilterTokenUpdates
Show Properties
Show Properties
The list of updated token results matching the subscription parameters.
See TokenFilterResult
Show Properties
Show Properties
Metadata for the token.
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 unix timestamp for the creation of the token’s first pair.
The unix timestamp for the token’s last transaction.
The number of buys in the past 5 minutes.
The number of buys in the past hour.
The number of buys in the past 12 hours.
The number of buys in the past 24 hours.
The number of buys in the past 4 hours.
The percent price change in the past 5 minutes. Decimal format.
The percent price change in the past hour. 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 price change in the past 4 hours. Decimal format.
The percent volume change in the past 5 minutes. 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 exchanges the token is listed on.
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 highest price in USD in the past 5 minutes.
The highest price in USD in the past hour.
The highest price in USD in the past 12 hours.
The highest price in USD in the past 24 hours.
The highest price in USD in the past 4 hours.
Amount of liquidity in the token’s top pair.
The token of interest. Can be
token0 or token1.The lowest price in USD in the past 5 minutes.
The lowest price in USD in the past hour.
The lowest price in USD in the past 12 hours.
The lowest price in USD in the past 24 hours.
The lowest price in USD in the past 4 hours.
The fully diluted market cap.
The circulating market cap.
Metadata for the token’s top 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.
Metadata for the token’s most liquid 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 liquidity of the token’s most liquid pair
The liquid pairs price in USD.
The token price in USD.
A heuristic based on various factors used to rank tokens based on how trending they are.
The number of sells in the past 5 minutes.
The number of sells in the past hour.
The number of sells in the past 12 hours.
The number of sells in the past 24 hours.
The number of sells in the past 4 hours.
The number of transactions in the past 5 minutes.
The number of transactions in the past hour.
The number of transactions in the past 12 hours.
The number of transactions in the past 24 hours.
The number of transactions in the past 4 hours.
The unique number of buys in the past 5 minutes.
The unique number of buys in the past hour.
The unique number of buys in the past 12 hours.
The unique number of buys in the past 24 hours.
The unique number of buys in the past 4 hours.
The unique number of sells in the past 5 minutes.
The unique number of sells in the past hour.
The unique number of sells in the past 12 hours.
The unique number of sells in the past 24 hours.
The unique number of sells in the past 4 hours.
The unique number of transactions in the past 5 minutes.
The unique number of transactions in the past hour.
The unique number of transactions in the past 12 hours.
The unique number of transactions in the past 24 hours.
The unique number of transactions in the past 4 hours.
The trade volume in USD in the past hour.
The trade volume in USD in the past 5 minutes.
The trade volume in USD in the past 12 hours.
The trade volume in USD in the past 24 hours.
The trade volume in USD in the past 4 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 buy volume in USD in the past 5 minutes.
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 sell volume in USD in the past 5 minutes.
The total pool fees in USD in the past 5 minutes.
The total pool fees in USD in the past hour.
The total pool fees in USD in the past 4 hours.
The total pool fees in USD in the past 12 hours.
The total pool fees in USD in the past 24 hours.
The total base gas fees in USD in the past 5 minutes.
The total base gas fees in USD in the past hour.
The total base gas fees in USD in the past 4 hours.
The total base gas fees in USD in the past 12 hours.
The total base gas fees in USD in the past 24 hours.
The total priority fees in USD in the past 5 minutes.
The total priority fees in USD in the past hour.
The total priority fees in USD in the past 4 hours.
The total priority fees in USD in the past 12 hours.
The total priority fees in USD in the past 24 hours.
The total builder tips (MEV) in USD in the past 5 minutes.
The total builder tips (MEV) in USD in the past hour.
The total builder tips (MEV) in USD in the past 4 hours.
The total builder tips (MEV) in USD in the past 12 hours.
The total builder tips (MEV) in USD in the past 24 hours.
The total L1 data fees in USD in the past 5 minutes.
The total L1 data fees in USD in the past hour.
The total L1 data fees in USD in the past 4 hours.
The total L1 data fees in USD in the past 12 hours.
The total L1 data fees in USD in the past 24 hours.
The total trading fees (pool + gas + tips) in USD in the past 5 minutes.
The total trading fees (pool + gas + tips) in USD in the past hour.
The total trading fees (pool + gas + tips) in USD in the past 4 hours.
The total trading fees (pool + gas + tips) in USD in the past 12 hours.
The total trading fees (pool + gas + tips) in USD in the past 24 hours.
The ratio of total fees to volume in the past 5 minutes. Decimal format.
The ratio of total fees to volume in the past hour. Decimal format.
The ratio of total fees to volume in the past 4 hours. Decimal format.
The ratio of total fees to volume in the past 12 hours. Decimal format.
The ratio of total fees to volume in the past 24 hours. Decimal format.
Whether the token has been flagged as a scam.
The number of different wallets holding the token.
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 number of wallets that have sniped the token
The percentage of tokens held by snipers
The number of wallets that have bundled the token
The percentage of tokens held by bundlers
The number of wallets that have been an insider of the token
The percentage of tokens held by insiders
The percentage of tokens held by the dev
The percentage of total supply held by the top 10 holders.
The reasons the token has been flagged as a potential scam.
See PotentialScamReason
Show Properties
Show Properties
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.
This field is deprecated. Age isn’t supported - use createdAt instead
This field is deprecated. FDV isn’t supported - use marketCap instead
Arguments
A set of filters to apply.
See TokenFilters
Show Properties
Show Properties
Recursive boolean expression for combining token filters.
See TokenBoolFilter
Show Properties
Show Properties
All nested filters must match.
See TokenFilters
At least one nested filter must match.
See TokenFilters
The nested filter must not match.
See TokenFilters
The unix timestamp for the creation of the token’s first pair.
See NumberFilter
The unix timestamp for the creation of the token.
See NumberFilter
The unix timestamp for the token’s last transaction.
See NumberFilter
The number of buys in the past 5 minutes.
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 percent price change in the past 5 minutes. Decimal format.
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 5 minutes. 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 list of exchange contract IDs to filter by. Applied in conjunction with
network filter using an OR condition. When used together, the query returns results that match either the specified exchanges or the specified network.The list of exchange contract addresses to filter by.
The highest price in USD in the past 5 minutes.
See NumberFilter
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 token’s top pair.
See NumberFilter
The lowest price in USD in the past hour.
See NumberFilter
The lowest price in USD in the past 5 minutes.
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 fully diluted market cap.
See NumberFilter
The circulating market cap.
See NumberFilter
The list of network IDs to filter by. Applied in conjunction with
exchangeId filter using an OR condition. When used together, the query returns results that match either the specified exchanges or the specified network.The number of different wallets holding the token.
See NumberFilter
The token price in USD.
See NumberFilter
The number of sells in the past hour.
See NumberFilter
The number of sells in the past 5 minutes.
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 number of transactions in the past 5 minutes.
See NumberFilter
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 5 minutes.
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 5 minutes.
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 5 minutes.
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 trade volume in USD in the past 5 minutes.
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 buy volume in USD in the past 5 minutes.
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
The sell volume in USD in the past 5 minutes.
See NumberFilter
Whether to include tokens that have been flagged as scams. Default: false
Whether to filter for tokens on testnet networks. Use
true for testnet tokens only, false for mainnet tokens only and undefined (default) for both.Only include verified tokens
Filter potential Scams
Whether to ignore pairs/tokens not relevant to trending. This is done checking against a few factors and ignoring uninteresting tokens like stables / network tokens. If you want all tokens regardless of these checks, then don’t include this field. (default) If you want only tokens that fail the trending ignore checks, then set it to
true. (i.e. stablecoins, rugs, network base tokens) If you want only tokens that pass the trending ignore checks, then set it to false.The addresses of the token creators (supports multiple addresses). Max 25 addresses. You cannot provide both creatorAddress and creatorAddresses.
A list of launchpad protocols.
A list of launchpad names. Any of the following: Pump.fun, Pump Mayhem, Bonk, BONAD.fun, Nad.Fun, Baseapp, Baseapp Creator, Zora, Zora Creator, Four.meme, Four.meme Fair, Believe, Moonshot, Jupiter Studio, boop, Heaven, TokenMill V2, Virtuals, Clanker, Clanker V4, ArenaTrade, Moonit, LaunchLab, MeteoraDBC, Meteora Alpha Vault, Zora Solana, Cooking.City, time.fun, BAGS, Circus, Dealr, OhFuckFun, PrintFun, Trend, shout.fun, xApple, Sendshot, DubDub, cults, OpenGameProtocol, AMERICA.fun, Kumbaya, Printr, Bankr, Liquid, Noice, Flaunch, Coinbarrel, Blowfish, MeMoo, Metaplex, Scale, Eitherway, Livo.
Indicates if the launchpad is completed.
Indicates if the launchpad has migrated.
The graduation percentage.
See NumberFilter
The timestamp when the launchpad was completed.
See NumberFilter
The timestamp when the launchpad was migrated.
See NumberFilter
The token is freezable.
The token is mintable.
Whether the token name or symbol contains profanity.
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 percentage of wallets that are less than 7d old that have traded in the last 24h.
See NumberFilter
Filter by total fees in the past 5 minutes.
See NumberFilter
Filter by total fees in the past hour.
See NumberFilter
Filter by total fees in the past 4 hours.
See NumberFilter
Filter by total fees in the past 12 hours.
See NumberFilter
Filter by total fees in the past 24 hours.
See NumberFilter
Filter by pool fees in the past 24 hours.
See NumberFilter
Filter by fee to volume ratio in the past 24 hours.
See NumberFilter
Filter by number of wallets that have sniped the token
See NumberFilter
Filter by percentage of tokens held by snipers
See NumberFilter
Filter by number of wallets that have bundled the token
See NumberFilter
Filter by percentage of tokens held by bundlers
See NumberFilter
Filter by number of wallets that have been an insider of the token
See NumberFilter
Filter by percentage of tokens held by insiders
See NumberFilter
Filter by percentage of tokens held by the dev
See NumberFilter
Filter by top 10 holders percentage.
See NumberFilter
Filter by whether the token has linked Grid asset data.
Filter by Grid bluechip ratings. Returns tokens matching any of the provided ratings.
Filter by all-time high price.
See NumberFilter
Filter by all-time low price.
See NumberFilter
Filter by all-time high FDV.
See NumberFilter
Filter by all-time low FDV.
See NumberFilter
Filter by all-time high circulating market cap.
See NumberFilter
Filter by all-time low circulating market cap.
See NumberFilter
See NumberFilter
This field is deprecated. Age isn’t supported - use createdAt instead
See NumberFilter
This field is deprecated. FDV isn’t supported - use marketCap instead
The address of the creator of the token.
This field is deprecated. Use creatorAddresses string array instead
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 partially match a token’s name or symbol.
A list of token IDs (
address:networkId) or addresses. Can be left blank to discover new tokens.A list of token IDs (
address:networkId) to exclude from resultsA list of ranking attributes to apply.
See TokenRanking
Show Properties
Show Properties
The attribute to rank tokens by.
See TokenRankingAttribute
Show Properties
Show Properties
This field is deprecated. Use createdAt instead
The direction to apply to the ranking attribute.
See RankingDirection
Flag to use aggregated token stats.
How long, in milliseconds, to batch token updates before emitting them. Defaults to 500ms and must be between 0 and 60000.
The maximum number of tokens to return.
Where in the list the server should start when returning items. Use
count+page from the previous query to request the next page of results.The first message delivers all tokens matching your filters. Subsequent messages only include tokens with updated data, returned at the interval you set via
updatePeriod. Every 30 seconds, the filter itself re-evaluates: if tokens start or stop meeting your filters, the result set updates automatically.subscription {
onFilterTokensUpdated(
limit: 25
filters: {buyVolume1: {gt: 10000}, top10HoldersPercent: {lt: 80}, marketCap: {gt: 100000, lt: 20000000}}
useAggregatedStats: true
rankings: {attribute: trendingScore24, direction: DESC}
updatePeriod: 500
) {
updates {
token {
info {
name
symbol
networkId
}
}
marketCap
priceUSD
change1
volume1
top10HoldersPercent
liquidity
}
}
}
Example Response
{
"data": {
"onFilterTokensUpdated": {
"updates": [
{
"token": {
"info": {
"name": "Flat Eric",
"symbol": "ooo",
"networkId": 1399811149
}
},
"marketCap": "1829189",
"priceUSD": "0.00195113499065",
"change1": "0.21374966245293178",
"volume1": "126901",
"top10HoldersPercent": 31.38365436675934,
"liquidity": "79447"
},
{
"token": {
"info": {
"name": "Peace Frog",
"symbol": "PEACE",
"networkId": 1399811149
}
},
"marketCap": "7095047",
"priceUSD": "0.00709505107906",
"change1": "-0.0418823989642306",
"volume1": "98114",
"top10HoldersPercent": 12.362009437839479,
"liquidity": "137270"
},
{
"token": {
"info": {
"name": "SPIKE",
"symbol": "SPIKE",
"networkId": 1399811149
}
},
"marketCap": "10145817",
"priceUSD": "0.0101458368323",
"change1": "-0.029693786111620973",
"volume1": "87815",
"top10HoldersPercent": 8.754611894819124,
"liquidity": "227631"
},
{
"token": {
"info": {
"name": "Larpcoin",
"symbol": "LARP",
"networkId": 1399811149
}
},
"marketCap": "904235",
"priceUSD": "0.00090423514265",
"change1": "0.16557388134971962",
"volume1": "181774",
"top10HoldersPercent": 20.51292553319232,
"liquidity": "40300"
},
{
"token": {
"info": {
"name": "哈基米",
"symbol": "哈基米",
"networkId": 56
}
},
"marketCap": "18268865",
"priceUSD": "0.0182688647732",
"change1": "-0.15041202192869108",
"volume1": "184963",
"top10HoldersPercent": 59.72826922461662,
"liquidity": "737724"
},
{
"token": {
"info": {
"name": "Tung Tung Tung Sahur",
"symbol": "TripleT",
"networkId": 1399811149
}
},
"marketCap": "3812896",
"priceUSD": "0.00381311474198",
"change1": "0.03728259993298412",
"volume1": "65648",
"top10HoldersPercent": 18.637573181722505,
"liquidity": "156325"
},
{
"token": {
"info": {
"name": "afk",
"symbol": "afk",
"networkId": 1399811149
}
},
"marketCap": "4248821",
"priceUSD": "0.00448164388206",
"change1": "0.023518386389426892",
"volume1": "11243",
"top10HoldersPercent": 15.219805376721089,
"liquidity": "151350"
},
{
"token": {
"info": {
"name": "Block Street",
"symbol": "BSB",
"networkId": 56
}
},
"marketCap": "14792062",
"priceUSD": "0.360374979334",
"change1": "-0.011605132198808736",
"volume1": "333721",
"top10HoldersPercent": 64.47136246550876,
"liquidity": "200176"
},
{
"token": {
"info": {
"name": "assface",
"symbol": "assface",
"networkId": 1399811149
}
},
"marketCap": "429130",
"priceUSD": "0.000429168549105",
"change1": "0.0039139458187899615",
"volume1": "106149",
"top10HoldersPercent": 23.25621437058673,
"liquidity": "38003"
},
{
"token": {
"info": {
"name": "uncraft",
"symbol": "uncraft",
"networkId": 1399811149
}
},
"marketCap": "4860071",
"priceUSD": "0.00486010293642",
"change1": "0.47386803384848103",
"volume1": "2141376",
"top10HoldersPercent": 15.659377708792855,
"liquidity": "111152"
},
{
"token": {
"info": {
"name": "fat choi",
"symbol": "发财",
"networkId": 1399811149
}
},
"marketCap": "2837240",
"priceUSD": "0.00296621392708",
"change1": "0.0034901703058449816",
"volume1": "80584",
"top10HoldersPercent": 38.76097132829333,
"liquidity": "97172"
},
{
"token": {
"info": {
"name": "unc",
"symbol": "unc",
"networkId": 1399811149
}
},
"marketCap": "7071256",
"priceUSD": "0.00707206012359",
"change1": "-0.064170587795235",
"volume1": "190729",
"top10HoldersPercent": 10.192638745751273,
"liquidity": "363956"
},
{
"token": {
"info": {
"name": "Wrapped MON",
"symbol": "WMON",
"networkId": 143
}
},
"marketCap": "11864092",
"priceUSD": "0.0339234271493",
"change1": "-0.003037937307371629",
"volume1": "806817",
"top10HoldersPercent": 59.53991890235804,
"liquidity": "9667761"
},
{
"token": {
"info": {
"name": "BELIEF",
"symbol": "BELIEF",
"networkId": 1399811149
}
},
"marketCap": "16080541",
"priceUSD": "0.0171526449453",
"change1": "-0.017646300856981517",
"volume1": "110988",
"top10HoldersPercent": 58.706574401235365,
"liquidity": "275007"
},
{
"token": {
"info": {
"name": "Dumb Money",
"symbol": "DUMBMONEY",
"networkId": 1399811149
}
},
"marketCap": "1108146",
"priceUSD": "0.00111617990749",
"change1": "-0.057635940913987604",
"volume1": "148757",
"top10HoldersPercent": 10.00502812835363,
"liquidity": "84105"
},
{
"token": {
"info": {
"name": "Huma Finance",
"symbol": "HUMA",
"networkId": 56
}
},
"marketCap": "11259237",
"priceUSD": "0.0246464157567",
"change1": "0.014621906976420972",
"volume1": "205621",
"top10HoldersPercent": 36.668810577350726,
"liquidity": "2832638"
},
{
"token": {
"info": {
"name": "Believe",
"symbol": "BELIEVE",
"networkId": 1399811149
}
},
"marketCap": "974088",
"priceUSD": "0.000761009418281",
"change1": "-0.12116746795530602",
"volume1": "131748",
"top10HoldersPercent": 48.243932294422876,
"liquidity": "43303"
},
{
"token": {
"info": {
"name": "Wrapped Sonic",
"symbol": "wS",
"networkId": 146
}
},
"marketCap": "10656021",
"priceUSD": "0.0438266970262",
"change1": "-0.007544105952512887",
"volume1": "29643",
"top10HoldersPercent": 72.3758553402159,
"liquidity": "1546888"
},
{
"token": {
"info": {
"name": "Wrapped ETH",
"symbol": "WETH",
"networkId": 2741
}
},
"marketCap": "7792414",
"priceUSD": "2400.40214443",
"change1": "-0.0014648585627610304",
"volume1": "18579",
"top10HoldersPercent": 24.376711845331464,
"liquidity": "6362821"
},
{
"token": {
"info": {
"name": "Wojak",
"symbol": "WOJAK",
"networkId": 1399811149
}
},
"marketCap": "3952627",
"priceUSD": "0.00395305266273",
"change1": "-0.07301419052147469",
"volume1": "65462",
"top10HoldersPercent": 20.747708963574766,
"liquidity": "285363"
},
{
"token": {
"info": {
"name": "Deployr",
"symbol": "Deployr",
"networkId": 1399811149
}
},
"marketCap": "748438",
"priceUSD": "0.00765675034212",
"change1": "-0.04677212604804801",
"volume1": "22672",
"top10HoldersPercent": 46.25422412860161,
"liquidity": "47431"
},
{
"token": {
"info": {
"name": "Dumb Money",
"symbol": "DUMBMONEY",
"networkId": 1399811149
}
},
"marketCap": "2839373",
"priceUSD": "0.00283937331254",
"change1": "53.170773887827416",
"volume1": "148762",
"top10HoldersPercent": 6.7282942456018,
"liquidity": "7106"
},
{
"token": {
"info": {
"name": "Justice for Evelyn",
"symbol": "EVELYN",
"networkId": 1399811149
}
},
"marketCap": "331370",
"priceUSD": "0.000331369977886",
"change1": "111.38237343868775",
"volume1": "482230",
"top10HoldersPercent": 4.6684968243218,
"liquidity": "23633"
},
{
"token": {
"info": {
"name": "Wrapped Polygon Ecosystem Token",
"symbol": "WPOL",
"networkId": 137
}
},
"marketCap": "19630736",
"priceUSD": "0.0935282748972",
"change1": "-0.0013144673725107396",
"volume1": "52459",
"top10HoldersPercent": 70.87448266847595,
"liquidity": "6339439"
},
{
"token": {
"info": {
"name": "Humanity",
"symbol": "H",
"networkId": 56
}
},
"marketCap": "16197678",
"priceUSD": "0.129283372611",
"change1": "-0.006961189205480443",
"volume1": "171817",
"top10HoldersPercent": 79.73114731398417,
"liquidity": "1151147"
}
]
}
}
}
Usage Guidelines
- Accepts the same filters, rankings, and limit arguments as the filterTokens query. If you’ve already built a filterTokens request, you can reuse it here as a subscription.
- The first message delivered contains the current state of the filtered set, so there’s no need to run a one-off filterTokens query first.
- Matched tokens push data updates on a configurable interval via
updatePeriod(defaults to 500ms if not specified, accepts any value in ms from 0ms to 60s). - The filter itself re-evaluates the token list every 30 seconds. If the set of matching tokens changes (a token starts meeting the filters, or stops meeting them), you’ll automatically receive updates reflecting the new set. This re-evaluation interval is not currently configurable.
- Ideal for keeping trending lists, leaderboards, or filtered dashboards live without manual polling.
- For ultra-low-latency token discovery (e.g. memescope-style interfaces) our Launchpad subscriptions may be a better fit for that use case.
- Apply the same quality filters (trendingScore, minimum volume, mcap range, liquidity, holders, etc.) you would on filterTokens to avoid low-quality tokens in the stream.
- Response limit remains 200 tokens per subscription.
Troubleshooting Tips
Do I still need to call filterTokens first to get the initial state?
Do I still need to call filterTokens first to get the initial state?
No. The first message delivered after subscribing contains the current filtered result set. You can treat the subscription as a full replacement for polling
filterTokens for most use cases.Why am I not receiving any updates after the first message?
Why am I not receiving any updates after the first message?
Tokens that match your filters will push data updates on a set
updatePeriod (default 500ms). If that period is set high (e.g. 60000 for 60s), pushes will be less frequent. The filter itself also re-evaluates every 30 seconds, so if the set of matching tokens hasn’t changed and no tokens in the set have new data in your updatePeriod window, you may see quiet stretches. Broadening your filters or lowering updatePeriod will confirm the stream is live.Can I make updates push faster than 500ms?
Can I make updates push faster than 500ms?
Yes. Set
updatePeriod to any value between 0ms and 60s. Note that 0ms means “as fast as events arrive,” which can mean high message volume on busy filter sets.Can I make the filter re-evaluate faster than every 30s?
Can I make the filter re-evaluate faster than every 30s?
Not currently. The 30-second filter re-evaluation is fixed. For very low-latency token discovery (e.g. memescope-style UIs), our launchpad subscriptions offer lower-latency streams for newly launched tokens.
Should I use this instead of polling filterTokens on an interval?
Should I use this instead of polling filterTokens on an interval?
It depends on your use case for
filterTokens, but in most instances, yes. This subscription is the intended replacement for poll-based refresh patterns on filterTokens.Can I change filters on an active subscription?
Can I change filters on an active subscription?
No. To change filters or rankings, close the current subscription and open a new one with the updated arguments.
Related Recipes
- Discover Tokens: Build token discovery pages with trending data, filters, and search
- Launchpads: Build a launchpad discovery view with real-time token lifecycle updates