Skip to main content
GET
/
top-traders
cURL
curl --request GET \
  --url https://api.jup.ag/perps/v1/top-traders \
  --header 'x-api-key: <api-key>'
{
  "marketMint": "<string>",
  "totalVolumeUsd": "<string>",
  "startTimestamp": 123,
  "endTimestamp": 123,
  "topTradersByPnl": [
    {
      "totalVolumeUsd": "<string>",
      "totalPnlUsd": "<string>",
      "owner": "<string>"
    }
  ],
  "topTradersByVolume": [
    {
      "totalVolumeUsd": "<string>",
      "totalPnlUsd": "<string>",
      "owner": "<string>"
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

Get API key via https://portal.jup.ag

Query Parameters

​
marketMint
enum<string>
required

Mint address for the given market to filter top trader data

Available options:
So11111111111111111111111111111111111111112,
7vfCXTUXx5WJV5JADk17DUJ4ksgau7utNKj4b963voxs,
3NZ9JMVBmGAqocybic2c7LQCJScmgsAZ6vQqTDzcqmJh
​
year
string
required

The year for the week to query

​
week
required

The week number (1-53) or "current" for the current week

Allowed value: "current"

Response

200 OK

​
marketMint
string
required

The market mint to filter top traders by.

​
totalVolumeUsd
string
required

The total volume (USD) for the market.

​
startTimestamp
number
required

The start timestamp for the week (UNIX timestamp in seconds).

​
endTimestamp
number
required

The end timestamp for the week (UNIX timestamp in seconds).

​
topTradersByPnl
object[]
required

The top 50 traders sorted by PNL in descending order.

​
topTradersByVolume
object[]
required

The top 50 traders sorted by volume in descending order.