Get Top Tokens

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

NameTypeDescription
limitInt

The maximum number of tokens to return. Max is 50.

networkFilter[Int!]

The list of network IDs to filter by.

resolutionString

The time frame for trending results. Can be 1, 5, 15, 30, 60, 240, 720, or 1D.

Response

NameTypeDescription
addressString!The contract address of the token.
createdAtIntThe unix timestamp for the creation of the token's first pair.
decimalsIntThe 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.
idString!The ID of the token (address:networkId). For example, 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2:1.
imageLargeUrlStringThe token logo URL.
imageSmallUrlStringThe token logo URL.
imageThumbUrlStringThe token logo URL.
isScamBooleanWhether the token has been flagged as a scam.
lastTransactionIntThe unix timestamp for the token's last transaction.
liquidityString!The total liquidity of the token's top pair in USD.
marketCapStringThe market cap of circulating supply.
nameString!The name of the token.
networkIdInt!The network ID the token is deployed on.
priceFloat!The token price in USD.
priceChangeFloat!The percent price change for the time frame requested. Decimal format.
priceChange1FloatThe percent price change in the past hour. Decimal format.
priceChange4FloatThe percent price change in the past 4 hours. Decimal format.
priceChange12FloatThe percent price change in the past 12 hours. Decimal format.
priceChange24FloatThe percent price change in the past 24 hours. Decimal format.
quoteTokenQuoteTokenThe token of interest. Can be token0 or token1.
resolutionString!The time frame for the results.
symbolString!The symbol for the token.
topPairIdString!The ID of the token's top pair (pairAddress:networkId).
txnCount1IntThe number of transactions in the past hour.
txnCount4IntThe number of transactions in the past 4 hours.
txnCount12IntThe number of transactions in the past 12 hours.
txnCount24IntThe number of transactions in the past 24 hours.
uniqueBuys1IntThe unique number of buys in the past hour.
uniqueBuys4IntThe unique number of buys in the past 4 hours.
uniqueBuys12IntThe unique number of buys in the past 12 hours.
uniqueBuys24IntThe unique number of buys in the past 24 hours.
uniqueSells1IntThe unique number of sells in the past hour.
uniqueSells4IntThe unique number of sells in the past 4 hours.
uniqueSells12IntThe unique number of sells in the past 12 hours.
uniqueSells24IntThe unique number of sells in the past 24 hours.
volumeString!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

πŸ‘‹

Join our Discord

Ask questions, share what you're working on and request new features :two-men-holding-hands::two-women-holding-hands: