Top Tokens

Returns a list of trending tokens across any given network(s).

Endpoint: listTopTokens

Method: POST

❗️

This endpoint is being deprecated. Use filterTokens for future trending token queries. https://docs.codex.io/reference/filtertokens

filterTokens(
  rankings: {attribute: trendingScore24, direction: DESC}
)

Arguments

Name	Type	Description
limit	Int	The maximum number of tokens to return. Max is 50.
networkFilter	[Int!]	The list of network IDs to filter by.
resolution	String	The time frame for trending results. Can be 1, 5, 15, 30, 60, 240, 720, or 1D.

Response

TokenWithMetadata

Name	Type	Description
address	String!	The contract address of the token.
createdAt	Int	The unix timestamp for the creation of the token's first pair.
decimals	Int	The precision to which the token can be divided. For example, the smallest unit for USDC is 0.000001 (6 decimals).
exchanges	[Exchange!] !	The exchanges the token is listed on.
id	String!	The ID of the token ( address:networkId ). For example, 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2:1 .
imageBannerUrl	String	The token banner URL.
imageLargeUrl	String	The token logo URL.
imageSmallUrl	String	The token logo URL.
imageThumbUrl	String	The token logo URL.
isScam	Boolean	Whether the token has been flagged as a scam.
lastTransaction	Int	The unix timestamp for the token's last transaction.
liquidity	String!	The total liquidity of the token's top pair in USD.
marketCap	String	The market cap of circulating supply.
name	String!	The name of the token.
networkId	Int!	The network ID the token is deployed on.
price	Float!	The token price in USD.
priceChange	Float!	The percent price change for the time frame requested. Decimal format.
priceChange1	Float	The percent price change in the past hour. Decimal format.
priceChange4	Float	The percent price change in the past 4 hours. Decimal format.
priceChange12	Float	The percent price change in the past 12 hours. Decimal format.
priceChange24	Float	The percent price change in the past 24 hours. Decimal format.
quoteToken	QuoteToken	The token of interest. Can be token0 or token1 .
resolution	String!	The time frame for the results.
symbol	String!	The symbol for the token.
topPairId	String!	The ID of the token's top pair ( pairAddress:networkId ).
txnCount1	Int	The number of transactions in the past hour.
txnCount4	Int	The number of transactions in the past 4 hours.
txnCount12	Int	The number of transactions in the past 12 hours.
txnCount24	Int	The number of transactions in the past 24 hours.
uniqueBuys1	Int	The unique number of buys in the past hour.
uniqueBuys4	Int	The unique number of buys in the past 4 hours.
uniqueBuys12	Int	The unique number of buys in the past 12 hours.
uniqueBuys24	Int	The unique number of buys in the past 24 hours.
uniqueSells1	Int	The unique number of sells in the past hour.
uniqueSells4	Int	The unique number of sells in the past 4 hours.
uniqueSells12	Int	The unique number of sells in the past 12 hours.
uniqueSells24	Int	The unique number of sells in the past 24 hours.
volume	String!	The volume over the time frame requested in USD.

👋

Join our Discord

Ask questions, share what you're working on and request new features 👬👭