Skip to main content
GET
/
v1
/
trade
/
{chain}
/
top-traders
Trade - Top Traders
curl --request GET \
  --url https://api.chainstream.io/v1/trade/{chain}/top-traders \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "tokenAddress": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN",
      "walletAddress": "3xd4LGVWtYXLBspR6X5JWbW49NXmEehfPtX6Kqx98b4w",
      "tradeCount": 100,
      "tradeAmount": "1000000",
      "buyCount": 60,
      "buyAmount": "600000",
      "buyAmountInUsd": "12000.50",
      "buyAmountInNative": "100.5",
      "sellCount": 40,
      "sellAmount": "400000",
      "sellAmountInUsd": "8000.30",
      "sellAmountInNative": "66.8"
    }
  ],
  "hasNext": false,
  "hasPrev": false,
  "startCursor": "<string>",
  "endCursor": "<string>",
  "total": 0
}

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,
bsc,
eth

Query Parameters

​
cursor
string

Pagination cursor

​
limit
integer<int64>
default:20

Maximum number of top traders to return (max 10)

Required range: 1 <= x <= 100
​
direction
enum<string>
default:next

Pagination direction (next or prev)

Available options:
next,
prev
​
tokenAddress
string
required

Token address to query trades

Example:

"6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN"

​
timeFrame
enum<string>
default:24h

Time frame for filtering trades

Available options:
30m,
1h,
2h,
4h,
6h,
8h,
12h,
24h
Example:

"24h"

​
sortType
enum<string>
default:desc

Sort type for trade results

Available options:
desc,
asc
Example:

"desc"

​
sortBy
enum<string>
default:tradeAmount

Field to sort trades by

Available options:
tradeAmount,
tradeCount
Example:

"tradeAmount"

Response

200 - application/json
​
data
object[]
required

Array of top traders data

​
hasNext
boolean
default:false

Indicates if there are more results

​
hasPrev
boolean
default:false

Indicates if there are previous results

​
startCursor
string

Cursor for first item in current page

​
endCursor
string

Cursor for last item in current page

​
total
integer<int64>
default:0

Total number of items