getHoldersTop

This API retrieves a list of top wallets interacting with a given token, ranked by trading volume. It provides insights into buying and selling activities.

Example Request

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

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

Endpoint: /findHoldersTop Method: GET Summary: Query the top wallet transactions for a specific token.Parameters

Name	Type	Required	Description	Example
apiKey	String	Yes	API Key for authentication
tokenAddress	String	Yes	Address of the token	GMk6j2defJhS7F194toqmJNFNhAkbDXhYJo5oR3Rpump
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": [
    {
      "walletAddress": "CEEXTqHaqbVriXoW4uvdaPShkMaHg9AWnFXLS1nS887C",
      "bought": 47796241.687638,
      "sideVolume": 467.707092564,
      "sold": 34208859.97132,
      "volume": 82005101.658958,
      "volumeUsd": 59905.444098740314
    }
  ]
}

Response Fields Explanation

Field	Type	Description
walletAddress	String	The blockchain address of the wallet interacting with the token.
bought	Double	Total amount of the token purchased by this wallet (in token units).
sideVolume	Double	Volume of the token traded on one side (e.g., buy or sell) in native currency (e.g., SOL).
sold	Double	Total amount of the token sold by this wallet (in token units).
volume	Double	Total trading volume of the token by this wallet (bought + sold, in token units).
volumeUsd	Double	Total trading volume converted to USD based on current market rates.