POST
/
ranking
/
{chain}
/
hotTokens
/
{duration}
curl --request POST \
  --url https://api-dex.chainstream.io/ranking/{chain}/hotTokens/{duration} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "sortBy": "marketData.marketCapInUsd",
  "sortDirection": "DESC",
  "filterBy": [
    {
      "field": "marketData.marketCapInUsd",
      "min": "50000"
    }
  ]
}'
[
  {
    "chain": "solana",
    "name": "USD Coin",
    "symbol": "USDC",
    "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "imageUrl": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v/logo.png",
    "socialMedias": "{\"twitter\":\"@circle\",\"website\":\"https://www.circle.com\"}",
    "tokenCreatedAt": "2024-03-14T12:00:00Z",
    "stats": {
      "volumesInUsd1m": "95000.77",
      "priceChangeRatioInUsd1m": "0.01",
      "trades1m": "270",
      "traders1m": "270",
      "volumesInUsd5m": "95000.77",
      "priceChangeRatioInUsd5m": "0.01",
      "trades5m": "270",
      "traders5m": "270",
      "volumesInUsd1h": "95000.77",
      "priceChangeRatioInUsd1h": "0.01",
      "trades1h": "270",
      "traders1h": "270",
      "volumesInUsd4h": "95000.77",
      "priceChangeRatioInUsd4h": "0.01",
      "trades4h": "270",
      "traders4h": "270",
      "volumesInUsd24h": "95000.77",
      "priceChangeRatioInUsd24h": "0.01",
      "trades24h": "270",
      "traders24h": "270"
    },
    "marketData": {
      "marketCapInUsd": "100000",
      "top10HoldingsRatio": "0.1",
      "top100HoldingsRatio": "0.5",
      "holders": "1000",
      "priceInUsd": "0.00000261383847574915906643405542",
      "tvlInUsd": "0.00000261383847574915906643405542"
    }
  }
]

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
chain
enum<string>
required

A chain name listed in supported networks

Available options:
sol,
base
​
duration
enum<string>
required

Duration of the ranking

Available options:
1m,
5m,
1h,
4h,
24h

Body

application/json
​
sortBy
enum<string>

Sort field

Available options:
marketData.priceInUsd,
stats.priceChangeRatioInUsd1m,
stats.priceChangeRatioInUsd5m,
stats.priceChangeRatioInUsd1h,
stats.priceChangeRatioInUsd4h,
stats.priceChangeRatioInUsd24h,
marketData.marketCapInUsd,
marketData.tvlInUsd,
marketData.top10HoldingsRatio,
marketData.top100HoldingsRatio,
marketData.holders,
stats.trades1m,
stats.trades5m,
stats.trades1h,
stats.trades4h,
stats.trades24h,
stats.traders1m,
stats.traders5m,
stats.traders1h,
stats.traders4h,
stats.traders24h,
stats.volumesInUsd1m,
stats.volumesInUsd5m,
stats.volumesInUsd1h,
stats.volumesInUsd4h,
stats.volumesInUsd24h,
tokenCreatedAt
Example:

"marketData.marketCapInUsd"

​
sortDirection
enum<string>
default:DESC

Sort Direction

Available options:
ASC,
DESC
​
filterBy
object[]

Filter field

Example:
[
  {
    "field": "marketData.marketCapInUsd",
    "min": "50000"
  }
]

Response

200 - application/json
​
chain
string
required

Blockchain network identifier

Example:

"solana"

​
name
string
required

Token name

Example:

"USD Coin"

​
symbol
string
required

Token symbol

Example:

"USDC"

​
address
string
required

Token mint address

Example:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

​
tokenCreatedAt
number
required

Token creation timestamp

Example:

"2024-03-14T12:00:00Z"

​
stats
object
required

Token stats

​
marketData
object
required

Market cap

​
imageUrl
string

Token image URL

Example:

"https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v/logo.png"

​
socialMedias
string

Social media links

Example:

"{\"twitter\":\"@circle\",\"website\":\"https://www.circle.com\"}"

Was this page helpful?