Get trader leaderboard
GET /api/v1/market-data/leaderboard
Returns a global ranking of traders sorted by realised PnL, win rate, or volume for a given time period or calendar-day window. PnL is net of protocol and integrator fees. Pass a user wallet address to retrieve a single wallet's rank within the leaderboard.
Query parameters
periodstring · enumOptionalDefault:
Time period (mutually exclusive with from/to)
allPossible values: fromstringOptional
Window start date YYYY-MM-DD UTC inclusive (requires to; mutually exclusive with period)
tostringOptional
Window end date YYYY-MM-DD UTC inclusive (requires from; mutually exclusive with period)
sort_bystring · enumOptionalDefault:
Sort criterion
pnlPossible values: userstringOptional
Wallet address — returns that wallet's rank instead of the full list
limitinteger · min: 1 · max: 500OptionalDefault:
Max results
100offsetintegerOptionalDefault:
Pagination offset
0Responses
200
OK
application/json
400
Bad Request
application/json
500
Internal Server Error
application/json
get/api/v1/market-data/leaderboard
GET /api/v1/market-data/leaderboard HTTP/1.1
Host: rest.ft.42.space/
Accept: */*
{
"data": [
{
"losingPredictions": 1,
"losingSells": 1,
"pnl": 1,
"pnlPct": 1,
"profitableSells": 1,
"rank": 1,
"totalVolume": 1,
"tradeCount": 1,
"walletAddress": "text",
"winRate": 1,
"winningPredictions": 1
}
],
"pagination": {
"hasMore": true,
"totalResults": 1
}
}Last updated