TokenFilterResult - Codex

token

EnhancedToken

Metadata for the token. See EnhancedToken

Show Properties

id

String!

The ID of the token (address:networkId).

address

String!

The contract address of the token.

cmcId

Int

The token ID on CoinMarketCap.

decimals

Int!

The precision to which the token can be divided. For example, the smallest unit for USDC is 0.000001 (6 decimals).

isScam

Boolean

Whether the token has been flagged as a scam.

name

String

The token name. For example, ApeCoin.

networkId

Int!

The network ID the token is deployed on.

symbol

String

The token symbol. For example, APE.

Community gathered links for the socials of this token. See SocialLinks

info

TokenInfo

More metadata about the token. See TokenInfo

gridAssetId

String

The Grid asset ID, if this token is linked to a Grid asset.

bluechipRating

String

The Grid bluechip rating for this token (e.g. A+, B-).

organization

Organization

The Grid organization associated with this token. See Organization

asset

Asset

The Grid asset associated with this token. See Asset

exchanges

[Exchange!]

A list of exchanges where the token has been traded. See Exchange

creatorAddress

String

The token creator’s wallet address.

creator

Wallet

The token creator’s wallet identity and profile, resolved from creatorAddress. Null when the token has no known creator. See Wallet

createBlockNumber

Int

The block height the token was created at.

createTransactionHash

String

The transaction hash of the token’s creation.

createdAt

Int

The unix timestamp for the creation of the token.

mintable

String

Returns mint authority address if token is mintable. If null, verify against isMintableValid.

freezable

String

Returns freeze authority address if token is freezable. If null, verify against isFreezableValid.

isFreezableValid

Boolean

Determines if freezable is a valid address or null value for the authority, or if the freezable state has not yet been determined.

isMintableValid

Boolean

Determines if mintable is a valid address or null value for the authority, or if the mintable state has not yet been determined.

launchpad

LaunchpadData

The launchpad data for the token, if applicable. See LaunchpadData

top10HoldersPercent

Float

The percentage of total supply held by the top 10 holders (excluding exchanges/pairs).

profanity

Boolean

Whether the token name or symbol contains profanity.

extrema

TokenExtrema

All-time high and low price/market cap data for the token. See TokenExtrema

coinCommunity

CoinCommunity

The Coin Community data for the token See CoinCommunity

extensions

TokenExtensions

Token extension metadata, if available. See TokenExtensions

tokenStandardCustomData

Erc7572CustomInfo

Token-standard-specific custom metadata — currently ERC-7572 contractURI fields, as used by Base B20 tokens. Null for tokens without a recognized token standard. See Erc7572CustomInfo

categories

[Category!]

totalSupply

String

deprecated

The total supply of the token.

This field is deprecated. Use the TokenInfo type

explorerData

ExplorerTokenData

deprecated

Information about the token from 3rd party sources. See ExplorerTokenData

This field is deprecated. Use the TokenInfo type

imageThumbUrl

String

deprecated

The thumbnail token logo URL.

This field is deprecated. Use the TokenInfo type

imageSmallUrl

String

deprecated

The small token logo URL.

This field is deprecated. Use the TokenInfo type

imageLargeUrl

String

deprecated

The large token logo URL.

This field is deprecated. Use the TokenInfo type

circulatingSupply

String

deprecated

The circulating supply of the token.

This field is deprecated. Use the TokenInfo type

pooled

String

deprecated

The amount of this token in the pair.

This field is deprecated. Pooled can be found on the pair instead

createdAt

Int

The unix timestamp for the creation of the token’s first pair.

lastTransaction

Int

The unix timestamp for the token’s last transaction.

buyCount5m

Int

The number of buys in the past 5 minutes.

buyCount1

Int

The number of buys in the past hour.

buyCount12

Int

The number of buys in the past 12 hours.

buyCount24

Int

The number of buys in the past 24 hours.

buyCount4

Int

The number of buys in the past 4 hours.

change5m

String

The percent price change in the past 5 minutes. Decimal format.

change1

String

The percent price change in the past hour. Decimal format.

change12

String

The percent price change in the past 12 hours. Decimal format.

change24

String

The percent price change in the past 24 hours. Decimal format.

change4

String

The percent price change in the past 4 hours. Decimal format.

volumeChange5m

String

The percent volume change in the past 5 minutes. Decimal format.

volumeChange1

String

The percent volume change in the past hour. Decimal format.

volumeChange4

String

The percent volume change in the past 4 hours. Decimal format.

volumeChange12

String

The percent volume change in the past 12 hours. Decimal format.

volumeChange24

String

The percent volume change in the past 24 hours. Decimal format.

exchanges

[Exchange]

The exchanges the token is listed on. See Exchange

Show Properties

id

String!

The ID of the exchange (address:id).

address

String!

The contract address of the exchange.

color

String

The hex string for the exchange color.

name

String

The name of the exchange.

exchangeVersion

String

The version of the exchange, if applicable.

iconUrl

String

The exchange logo URL.

networkId

Int!

The network ID the exchange is deployed on.

tradeUrl

String

The URL for the exchange.

high5m

String

The highest price in USD in the past 5 minutes.

high1

String

The highest price in USD in the past hour.

high12

String

The highest price in USD in the past 12 hours.

high24

String

The highest price in USD in the past 24 hours.

high4

String

The highest price in USD in the past 4 hours.

liquidity

String

Amount of liquidity in the token’s top pair.

quoteToken

String

The token of interest. Can be token0 or token1.

low5m

String

The lowest price in USD in the past 5 minutes.

low1

String

The lowest price in USD in the past hour.

low12

String

The lowest price in USD in the past 12 hours.

low24

String

The lowest price in USD in the past 24 hours.

low4

String

The lowest price in USD in the past 4 hours.

marketCap

String

The fully diluted market cap.

circulatingMarketCap

String

The circulating market cap.

pair

Pair

Metadata for the token’s top pair. See Pair

Show Properties

address

String!

The contract address of the pair.

exchangeHash

String!

The address for the exchange factory contract.

fee

Int

The exchange fee for swaps.

id

String!

The ID for the pair (address:networkId).

networkId

Int!

The network ID the pair is deployed on.

protocol

String

The protocol of the pair. E.g. UniswapV4, RaydiumV4, PumpV1, etc.

tickSpacing

Int

The amount of required tick separation. Only applicable for pairs on UniswapV3.

token0

String!

The contract address of token0.

token1

String!

The contract address of token1.

createdAt

Int

The unix timestamp for the creation of the pair.

token0Data

EnhancedToken

Metadata for the first token in the pair. See EnhancedToken

token1Data

EnhancedToken

Metadata for the second token in the pair. See EnhancedToken

pooled

PooledTokenValues

The pooled amounts of each token in the pair. See PooledTokenValues

virtualPooled

PooledTokenValues

The virtual pooled amounts of each token in the pair. See PooledTokenValues

protocolData

ProtocolData

Custom data for the pair, only certain protocols have this. (uniswapv4, arenatrade for example) See ProtocolData

protocolCustomData

PairProtocolCustomData

deprecated

The per-protocol data for the pair, if applicable See PairProtocolCustomData

This field is deprecated. Use protocolData instead

liquidPair

Pair

Metadata for the token’s most liquid pair See Pair

liquidPairLiquidity

String

The liquidity of the token’s most liquid pair

liquidPairPriceUSD

String

The liquid pairs price in USD.

priceUSD

String

The token price in USD.

A heuristic based on various factors used to rank tokens based on how trending they are.

sellCount5m

Int

The number of sells in the past 5 minutes.

sellCount1

Int

The number of sells in the past hour.

sellCount12

Int

The number of sells in the past 12 hours.

sellCount24

Int

The number of sells in the past 24 hours.

sellCount4

Int

The number of sells in the past 4 hours.

txnCount5m

Int

The number of transactions in the past 5 minutes.

txnCount1

Int

The number of transactions in the past hour.

txnCount12

Int

The number of transactions in the past 12 hours.

txnCount24

Int

The number of transactions in the past 24 hours.

txnCount4

Int

The number of transactions in the past 4 hours.

uniqueBuys5m

Int

The unique number of buys in the past 5 minutes.

uniqueBuys1

Int

The unique number of buys in the past hour.

uniqueBuys12

Int

The unique number of buys in the past 12 hours.

uniqueBuys24

Int

The unique number of buys in the past 24 hours.

uniqueBuys4

Int

The unique number of buys in the past 4 hours.

uniqueSells5m

Int

The unique number of sells in the past 5 minutes.

uniqueSells1

Int

The unique number of sells in the past hour.

uniqueSells12

Int

The unique number of sells in the past 12 hours.

uniqueSells24

Int

The unique number of sells in the past 24 hours.

uniqueSells4

Int

The unique number of sells in the past 4 hours.

uniqueTransactions5m

Int

The unique number of transactions in the past 5 minutes.

uniqueTransactions1

Int

The unique number of transactions in the past hour.

uniqueTransactions12

Int

The unique number of transactions in the past 12 hours.

uniqueTransactions24

Int

The unique number of transactions in the past 24 hours.

uniqueTransactions4

Int

The unique number of transactions in the past 4 hours.

volume1

String

The trade volume in USD in the past hour.

volume5m

String

The trade volume in USD in the past 5 minutes.

volume12

String

The trade volume in USD in the past 12 hours.

volume24

String

The trade volume in USD in the past 24 hours.

volume4

String

The trade volume in USD in the past 4 hours.

buyVolume1

String

The buy volume in USD in the past hour.

buyVolume12

String

The buy volume in USD in the past 12 hours.

buyVolume24

String

The buy volume in USD in the past 24 hours.

buyVolume4

String

The buy volume in USD in the past 4 hours.

buyVolume5m

String

The buy volume in USD in the past 5 minutes.

sellVolume1

String

The sell volume in USD in the past hour.

sellVolume12

String

The sell volume in USD in the past 12 hours.

sellVolume24

String

The sell volume in USD in the past 24 hours.

sellVolume4

String

The sell volume in USD in the past 4 hours.

sellVolume5m

String

The sell volume in USD in the past 5 minutes.

poolFees5m

String

The total pool fees in USD in the past 5 minutes.

poolFees1

String

The total pool fees in USD in the past hour.

poolFees4

String

The total pool fees in USD in the past 4 hours.

poolFees12

String

The total pool fees in USD in the past 12 hours.

poolFees24

String

The total pool fees in USD in the past 24 hours.

baseFees5m

String

The total base gas fees in USD in the past 5 minutes.

baseFees1

String

The total base gas fees in USD in the past hour.

baseFees4

String

The total base gas fees in USD in the past 4 hours.

baseFees12

String

The total base gas fees in USD in the past 12 hours.

baseFees24

String

The total base gas fees in USD in the past 24 hours.

priorityFees5m

String

The total priority fees in USD in the past 5 minutes.

priorityFees1

String

The total priority fees in USD in the past hour.

priorityFees4

String

The total priority fees in USD in the past 4 hours.

priorityFees12

String

The total priority fees in USD in the past 12 hours.

priorityFees24

String

The total priority fees in USD in the past 24 hours.

builderTips5m

String

The total builder tips (MEV) in USD in the past 5 minutes.

builderTips1

String

The total builder tips (MEV) in USD in the past hour.

builderTips4

String

The total builder tips (MEV) in USD in the past 4 hours.

builderTips12

String

The total builder tips (MEV) in USD in the past 12 hours.

builderTips24

String

The total builder tips (MEV) in USD in the past 24 hours.

l1DataFees5m

String

The total L1 data fees in USD in the past 5 minutes.

l1DataFees1

String

The total L1 data fees in USD in the past hour.

l1DataFees4

String

The total L1 data fees in USD in the past 4 hours.

l1DataFees12

String

The total L1 data fees in USD in the past 12 hours.

l1DataFees24

String

The total L1 data fees in USD in the past 24 hours.

totalFees5m

String

The total trading fees (pool + gas + tips) in USD in the past 5 minutes.

totalFees1

String

The total trading fees (pool + gas + tips) in USD in the past hour.

totalFees4

String

The total trading fees (pool + gas + tips) in USD in the past 4 hours.

totalFees12

String

The total trading fees (pool + gas + tips) in USD in the past 12 hours.

totalFees24

String

The total trading fees (pool + gas + tips) in USD in the past 24 hours.

feeToVolumeRatio5m

String

The ratio of total fees to volume in the past 5 minutes. Decimal format.

feeToVolumeRatio1

String

The ratio of total fees to volume in the past hour. Decimal format.

feeToVolumeRatio4

String

The ratio of total fees to volume in the past 4 hours. Decimal format.

feeToVolumeRatio12

String

The ratio of total fees to volume in the past 12 hours. Decimal format.

feeToVolumeRatio24

String

The ratio of total fees to volume in the past 24 hours. Decimal format.

isScam

Boolean

Whether the token has been flagged as a scam.

holders

Int

The number of different wallets holding the token.

walletAgeAvg

String

The average age of the wallets that traded in the last 24h

walletAgeStd

String

The standard deviation of age of the wallets that traded in the last 24h

swapPct1dOldWallet

String

The percentage of wallets that are less than 1d old that have traded in the last 24h

swapPct7dOldWallet

String

The percentage of wallets that are less than 7d old that have traded in the last 24h

sniperCount

Int

The number of wallets that have sniped the token

sniperHeldPercentage

Float

The percentage of tokens held by snipers

bundlerCount

Int

The number of wallets that have bundled the token

bundlerHeldPercentage

Float

The percentage of tokens held by bundlers

insiderCount

Int

The number of wallets that have been an insider of the token

insiderHeldPercentage

Float

The percentage of tokens held by insiders

suspiciousCount

Int

The number of suspicious wallets (deduplicated union of snipers, bundlers, and insiders)

suspiciousHeldPercentage

Float

The percentage of tokens held by suspicious wallets

devHeldPercentage

Float

The percentage of tokens held by the dev

top10HoldersPercent

Float

The percentage of total supply held by the top 10 holders.

potentialScamReasons

[PotentialScamReason]

The reasons the token has been flagged as a potential scam. See PotentialScamReason

Show Properties

MinimumLiquidity

enum

The token does not meet the minimum liquidity threshold.

LiquidityRugPull

enum

The token has experienced a significant drop in liquidity.

SuspiciousWalletActivity

enum

The token has suspicious wallet activity.

AbnormalBuyerRatio

enum

The token has an abnormal buyer ratio.

athPrice

String

The all-time high price in USD.

athPriceTimestamp

Int

The unix timestamp when the all-time high price was reached.

atlPrice

String

The all-time low price in USD.

atlPriceTimestamp

Int

The unix timestamp when the all-time low price was reached.

athFdv

String

The all-time high fully diluted market cap.

athFdvTimestamp

Int

The unix timestamp when the all-time high FDV was reached.

atlFdv

String

The all-time low fully diluted market cap.

atlFdvTimestamp

Int

The unix timestamp when the all-time low FDV was reached.

athCircMc

String

The all-time high circulating market cap.

athCircMcTimestamp

Int

The unix timestamp when the all-time high circulating market cap was reached.

atlCircMc

String

The all-time low circulating market cap.

atlCircMcTimestamp

Int

The unix timestamp when the all-time low circulating market cap was reached.

age

Int

deprecated

This field is deprecated. Age isn’t supported - use createdAt instead

fdv

String

deprecated

This field is deprecated. FDV isn’t supported - use marketCap instead

Used By

Returned by

categoryTokens
filterTokens: Discover, screen, and rank tokens across every supported network using 100+ on-chain signals: trading activity, liquidity, holder behavior, fee economics, and launchpad lifecycle.
onFilterTokensUpdated: Live-streamed filter token updates for the current filterTokens result set.

TokenInfoMetadata for a token.

⌘I