🆕Hyperliquid Address Leaderboard

Get Perpetual Trading Leaderboard Data

post

Get perpetual trading leaderboard data showing the most profitable traders within a given date range. This endpoint provides trader performance metrics including total PnL, ROI, and account values.

What it helps to answer:

1. Who are the most profitable perpetual traders in a given timeframe?

2. What are the ROI percentages for top performing traders?

3. What are the account values of successful perpetual traders?

4. How do trader addresses and labels correlate with performance?

Key Features:

• Trader address and label information

• Total PnL tracking in USD

• ROI calculations as percentages

• Account value tracking

• Flexible filtering and sorting options

Authorizations

ApiKeyAuth

apiKeystringRequired

API key for authentication

Body

application/json

Request model for Perp Leaderboard endpoint. This endpoint provides a perpetual trading leaderboard showing the most profitable traders within a given date range.

filtersany ofOptional

Additional filters to apply to the query.

Example: {"account_value":{"min":10000},"total_pnl":{"min":1000}}

order_byany ofOptional

Custom sort order to override the endpoint's default ordering

Responses

200

Perpetual trading leaderboard data

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

404

Not Found

application/json

422

Unprocessable Content

application/json

429

Too Many Requests

application/json

500

Internal Server Error

application/json

post

/api/v1/perp-leaderboard

HTTPcURLJavaScriptPython

POST /api/v1/perp-leaderboard HTTP/1.1
Host: api.nansen.ai
apiKey: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 206

{
  "date": {
    "from": "2025-10-14",
    "to": "2025-10-15"
  },
  "pagination": {
    "page": 1,
    "per_page": 10
  },
  "filters": {
    "account_value": {
      "min": 10000
    },
    "total_pnl": {
      "min": 1000
    }
  },
  "order_by": [
    {
      "field": "total_pnl",
      "direction": "ASC"
    }
  ]
}

{
  "data": [
    {
      "trader_address": "0x28c6c06298d514db089934071355e5743bf21d60",
      "trader_address_label": "🏦 Binance 14 [0x28c6c0]",
      "total_pnl": 1250.5,
      "roi": 15.5,
      "account_value": 10000
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10,
    "is_last_page": true
  }
}