Skip to main content
GET
cURL
Use this endpoint for the best wallets in one sport, or with league in one league. It returns the board the sport pages on 0xinsider.com show. It needs a Pro or Max key. For the leaderboard across every sport and esport, use Leaderboard. To find the league slugs, use Leaderboard leagues.

Parameters

How each sort ranks

Every board holds at most 100 wallets, and a wallet needs min_resolved resolved markets in the sport or league to be on it. There is no cursor: limit takes the top of the board.

Key response fields

Example

What it does not return

  • Wallets past the top 100. The board is ranked to 100 rows.
  • Open positions or live P&L. Every figure comes from resolved markets.
  • A board while the ranking is being rebuilt. The endpoint returns 503 read_model_warming with Retry-After instead.

Caching

The response carries an ETag. Send it back as If-None-Match to get 304 Not Modified with an empty body when the board has not changed.

Authorizations

Authorization
string
header
required

Legacy default or named integration API key, or OAuth 2.1 access token, in the Authorization header as Bearer oxi_sk_live_... or Bearer oxi_at_.... Default keys retain full access; integration keys are limited to their approved read, webhooks, export and usage scopes and expire within 90 days. All credentials share the owner's account limits. Data calls require an active Pro subscription and return live data. A 401 carries WWW-Authenticate: Bearer resource_metadata="https://api.0xinsider.com/.well-known/oauth-protected-resource" (RFC 6750 section 3, RFC 9728).

Headers

X-Query-Validation
enum<string>

Opt into strict query-name validation. The default is compatible: unknown names are ignored and reported in X-Query-Ignored. With strict, an unknown name returns 400 bad_request with error.reason unknown_query_parameter before the handler runs, including when its percent escape is incomplete.

Available options:
strict
If-None-Match
string

Conditional GET validator from a previous ETag. Matching values return 304 Not Modified with an empty body.

Path Parameters

sport
string
required

The sport slug, for example soccer, basketball, football or esports. Matched case-insensitively. A league or title alias such as nba, epl or cs2 reads its sport's board, and the body's sport is that board's slug; pass league for one league's board.

Query Parameters

league
string

A league slug of the sport, for example premier-league or cs2, from GET /api/v1/leaderboard/leagues. Omit it for the sport board.

sort
enum<string>
default:edge

Ranking axis. Any other value returns 400 bad_request with error.param=sort.

Available options:
edge,
pnl,
win_rate
limit
integer
default:20

Rows to return from the top of the board. Out-of-range values are clamped to 1..100.

Required range: 1 <= x <= 100

Response

Sport or league leaderboard

object
string
required
Allowed value: "sport_leaderboard"
data
object
required
meta
object
required