Get trader leaderboard

GET /api/v1/market-data/leaderboard

Get trader leaderboard

get

Returns a global ranking of traders sorted by realised PnL, win rate, or volume for a given time period. Pass a user wallet address to retrieve a single wallet's rank within the leaderboard.

Query parameters

periodstring · enumOptional

Time period

Default: allPossible values:

sort_bystring · enumOptional

Sort criterion

Default: pnlPossible values:

userstringOptional

Wallet address — returns that wallet's rank instead of the full list

limitinteger · min: 1 · max: 500Optional

Max results

Default: 100

offsetintegerOptional

Pagination offset

Default: 0

Responses

200

OK

application/json

400

Bad Request

application/json

500

Internal Server Error

application/json

get

/api/v1/market-data/leaderboard

HTTPcURLJavaScriptPython

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
  }
}