getHotPairs

This API provides a list of trending tokens based on trading activity, including transaction counts, USD volumes

Example Request

Here’s an example of calling the API using curl:

curl -L \
  --request GET \
  --url "https://api.saturnx.dev/api/process/getHotPairs?apiKey=111&count=100&page=1&blockchain=solana" \
  --header "Content-Type: application/json"

Endpoint: /findHotPairs Method: GET Summary: Retrieve data for popular tokens on the specified blockchain.

Name	Type	Required	Description	Example
apiKey	String	Yes	API Key for authentication
count	Integer	Yes	Number of records per page	100
page	Integer	Yes	Page number	1
blockchain	String	Yes	Blockchain identifier	solana

Response

• Status: 200 (Success)

• Content Type: application/json

• Structure:

json

{
  "code": 200,
  "message": "Operation Successful",
  "data": [
    {
      "amount": 4837.522915763,
      "count": 12305,
      "dexes": 1,
      "traders": 551,
      "usd": 620129.6773004186,
      "baseMintAddress": "BHtArQmW4RHxKrkFkaiUjkfXEpreNZq5rNG4P1AVs126",
      "baseName": "Nillion",
      "baseSymbol": "NIL",
      "quotaMintAddress": "So11111111111111111111111111111111111111112",
      "quotaName": "Wrapped Solana",
      "quotaSymbol": "WSOL",
      "price5minAgo": 7.713947775990994e-9,
      "price1hAgo": 5.601267062857509e-9,
      "price3hAgo": 4.054049375393783e-9,
      "price6hAgo": 1.227846548458935e-9,
      "priceLast": 7.713947775990994e-9,
      "price5minPercent": 0,
      "price1hPercent": 37.72,
      "price3hPercent": 90.28,
      "price6hPercent": 528.25,
      "attributeList": null
    }
  ]
}

Response Fields Explanation

Field	Type	Description
amount	Double	Total amount of the token traded (in token units).
count	Integer	Total number of transactions involving this token.
dexes	Integer	Number of decentralized exchanges (DEXes) where the token is traded.
traders	Integer	Number of unique traders interacting with this token.
usd	Double	Total trading volume in USD.
baseMintAddress	String	Address of the token (base token in the trading pair).
baseName	String	Name of the base token.
baseSymbol	String	Symbol of the base token.
quotaMintAddress	String	Address of the paired token (quote token, e.g., WSOL).
quotaName	String	Name of the quote token.
quotaSymbol	String	Symbol of the quote token.
price5minAgo	Double	Price of the token 5 minutes ago (in quote token units).
price1hAgo	Double	Price of the token 1 hour ago (in quote token units).
price3hAgo	Double	Price of the token 3 hours ago (in quote token units).
price6hAgo	Double	Price of the token 6 hours ago (in quote token units).
priceLast	Double	Most recent price of the token (in quote token units).
price5minPercent	Double	Percentage change in price over the last 5 minutes.
price1hPercent	Double	Percentage change in price over the last 1 hour.
price3hPercent	Double	Percentage change in price over the last 3 hours.
price6hPercent	Double	Percentage change in price over the last 6 hours.
attributeList	Object	Additional attributes or metadata (null if not applicable).