Skip to main content
GET
List your top traders by realized performance

Authorizations

X-API-Key
string
header
required

Organization API key (hp_live_...), sent in the X-API-Key header. Create, rotate and restrict keys in the dashboard or with the API keys endpoints; an organization can have two active keys, so you can rotate without downtime. A full-access key can call every endpoint in this reference. A read-only key can call GET endpoints (and create a trading stream token); any other request returns 403 READ_ONLY_KEY. A key with an IP allowlist returns 403 IP_NOT_ALLOWED from any other address. Each endpoint lists which keys can call it under Access.

Headers

If-None-Match
string

Optional. The ETag of the answer you already have. When the answer would be the same, the response is 304 without a body.

Query Parameters

days
enum<integer>
default:30

Look-back period in days

Available options:
7,
30,
90
accountType
string

Comma-separated account types: evaluation, sim_funded, competition

Maximum string length: 100
planId
string

Comma-separated plan IDs, at most 50; none for accounts without a plan

Maximum string length: 2000
minTrades
integer
default:5

Leave out traders with fewer trades

Required range: 1 <= x <= 1000
limit
integer
default:100

How many traders to return, at most 200

Required range: 1 <= x <= 200
sort
enum<string>
default:best

best returns the highest realized P&L first; worst returns the lowest first (the mirror leaderboard, e.g. to fade serial losers)

Available options:
best,
worst
assetClass
enum<string>

Only one kind of market: future (CME Group futures) or perpetual (perpetuals). Omit for both

Available options:
future,
perpetual
market
string

Comma-separated markets your organization is enabled for: futures CME, CBOT, NYMEX, COMEX; perpetuals HDL, BINANCE, HYPERLIQUID. With assetClass, every market must be of that class

Maximum string length: 84

Response

Top traders, best first

success
boolean
Example:

true

data
object