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

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
get/api/v1/token-races/leaderboard

Last updated