Returns a list of trending tokens across any given network(s).
Endpoint: listTopTokens
Method: POST
The Defined API determines which tokens are trending based on 3 main factors:
- Volume
- Liquidity
- Recent high volume activity
Arguments
Response
| 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. |
Example
Trending tokens on ETH
Use this query to find the top 5 trending tokens on ETH (1) with 1 day stats
{
listTopTokens(limit: 5, networkFilter: 1, resolution: "1D") {
address
decimals
exchanges {
address
id
name
iconUrl
networkId
tradeUrl
}
id
liquidity
name
networkId
price
priceChange
resolution
symbol
topPairId
volume
}
}
Explore
Ask questions, share what you're working on and request new features 👬👭