v1
latestOpenAPI 3.1.02026-07-2359362475.0 KBPerp 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:
- Who are the most profitable perpetual traders in a given timeframe?
- What are the ROI percentages for top performing traders?
- What are the account values of successful perpetual traders?
- 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
Response
Perpetual trading leaderboard data