Get race leaderboard

GET /api/v1/token-races/leaderboard

Get race leaderboard

get

Ranks wallets over finalised token races (Blitz) within a time period or UTC calendar-day window, sorted by longest consecutive winning-race run by default. Every row also reports losses and longestLossStreak (the losing mirror of wins / bestStreak over the same window), though neither is a sort option. Treasury wallets and the deployment's configured market-maker wallets are excluded. Pass user for a single wallet's rank. For live ranks inside the current race window, use the race-coordinator's GET /race/leaderboard/me instead — this endpoint only sees races that have been finalised onchain.

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

Primary sort criterion. win_rate is unweighted — one won race outranks a long profitable run.

Default: best_streakPossible 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/token-races/leaderboard

HTTPcURLJavaScriptPython

GET /api/v1/token-races/leaderboard HTTP/1.1
Host: rest.ft.42.space/
Accept: */*

{
  "data": [
    {
      "bestStreak": 1,
      "longestLossStreak": 1,
      "losses": 1,
      "racePnl": 1,
      "racesPlayed": 1,
      "rank": 1,
      "walletAddress": "text",
      "winRate": 1,
      "wins": 1
    }
  ],
  "pagination": {
    "hasMore": true,
    "totalResults": 1
  }
}