Skip to main content
GET
/
v1
/
trade
/
{chain}
/
gainers-losers
Trade - Gainers/Losers
curl --request GET \
  --url https://api-dex.chainstream.io/v1/trade/{chain}/gainers-losers \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "address": "FciNKwZAvSzepKH1nFEGeejzbP4k87dJiP9BAzGt2Sm3",
      "pnl": 1,
      "tradeCount": 1,
      "volume": 1
    }
  ],
  "hasNext": false,
  "hasPrev": false,
  "startCursor": "<string>",
  "endCursor": "<string>",
  "total": 123
}

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,
bsc,
polygon,
arbitrum,
optimism,
avalanche,
eth,
zksync,
sui

Query Parameters

​
cursor
string

Pagination cursor

​
limit
number
default:10

Maximum number of top traders to return (max 10)

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

Pagination direction (next or prev)

Available options:
next,
prev
​
type
enum<string>
default:1W

Specify the type of top gainers/losers. Filter for records with type equal to the specified type

Available options:
1W,
today,
yesterday
Example:

"1W"

​
sortBy
enum<string>
default:PnL

Specify the sort field

Available options:
PnL
Example:

"PnL"

​
sortType
enum<string>
default:desc

Specify the sort order

Available options:
desc,
asc
Example:

"desc"

Response

200 - application/json
​
data
object[]
required

Array of gainers and losers 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
number

Total number of items