v1

latestOpenAPI 3.1.02026-07-2359362475.0 KB
Perp Leaderboard

Get Perpetual Trading Leaderboard Data

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

Label Tier Control (premium_labels): When omitted or set to false (the default), the response contains free-tier labels and the request is billed at the standard credit cost for this endpoint. Passing premium_labels=true returns premium labels (Smart Money, Fund, and other advanced labels), is billed at 150 credits per call, and requires a paid plan.

post/api/v1/perp-leaderboard

Request body

premium_labelsboolean

Controls label tier in the response. When null/omitted or false (the default), returns free-tier labels at the standard credit cost for this endpoint. When true, returns premium labels (Smart Money, Fund, and other advanced labels), is billed at 150 credits per call, and requires a paid plan.

Response

Perpetual trading leaderboard data