Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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 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 · enumOptional

Time period (mutually exclusive with from/to)

Default: 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 · 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
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