> ## Documentation Index
> Fetch the complete documentation index at: https://docs.0xinsider.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> The Markdown of an API reference page leaves out the OpenAPI schema.
> Every object an endpoint returns or a webhook carries, with each field's type, presence and meaning, is on https://docs.0xinsider.com/api-reference/objects.md.
> The full OpenAPI 3.1 spec names each operation's and each webhook's exact parameters, request body and response schema: https://docs.0xinsider.com/api-reference/openapi.json.

# Sport leaderboard

> Get one sport's or one league's wallet leaderboard, ranked by edge, P&L, or win rate.

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](https://docs.0xinsider.com/api-reference/endpoint/get-leaderboard.md). To find the league slugs, use [Leaderboard leagues](https://docs.0xinsider.com/api-reference/endpoint/list-leaderboard-leagues.md).

## Parameters

| Parameter | Description |
| - | - |
| `sport` | Required, in the path. A sport slug, for example `soccer`, `basketball`, `football`, or `esports`. A league or title alias such as `nba`, `epl` or `cs2` reads its sport's board, and the response's `sport` is that board's slug; pass `league` for one league. A slug outside sports and esports returns `404` with `error.param` `sport`. |
| `league` | Optional. A league slug of that sport, for example `premier-league`. Leave it out for the sport's board. A league the sport has no board for returns `404` with `error.param` `league`. |
| `sort` | Optional. `edge` (the default), `pnl`, or `win_rate`. Any other value returns `400` with `error.param` `sort`. |
| `limit` | Optional. The number of rows from the top of the board, from 1 to 100. The default is 20. |

## How each sort ranks

| `sort` | Ranks by |
| - | - |
| `edge` | `edge_skill`: how much more often the wallet's side won than the prices it paid implied, pulled toward the board's `edge_average` by how much of its record could be luck. A wallet with no ranked edge is listed after the ranked ones. |
| `pnl` | Realized P\&L in the sport or league. |
| `win_rate` | `win_rate_wilson_lb`, the lower bound of the win rate, so a short lucky record does not rank first. |

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

| Field | Meaning |
| - | - |
| `sport`, `category` | The slug you sent and the sport it matched, for example `Soccer`. `category` is `null` when no wallet has a record in that sport. |
| `league` | The league's `slug`, `name`, and `ranked_traders`. `null` on a sport board. |
| `total_traders` | The number of wallets with at least `min_resolved` resolved markets and a trade, in any market, in the last 180 days. |
| `edge_average` | The average edge that `edge_skill` is pulled toward. `null` when no wallet has a ranked edge. |
| `volume_scope` | What `volume` counts. It is `sports_and_esports`: the wallet's volume across all sports and esports, not only this sport. |
| `as_of` | When the newest row on the board was ranked. |
| `rows[].id` | The wallet's trader ID, `trd_0x...`. |
| `rows[].grade` | The wallet's all-time 0xinsider grade, `S` to `F`. It is led by realized profit across all of the wallet's sports and esports markets, not this sport's, so a wallet can lead a board on in-sport P\&L and still grade `F`. Every other figure on the row is in the sport or league. |
| `rows[].wins`, `losses`, `win_rate` | The wallet's record in the sport or league. `win_rate` is a fraction from 0 to 1. |
| `rows[].price_edge` | The edge measurement: `markets`, `hit_rate`, `avg_price`, `edge`, `edge_lower`, and `status` (`ranked`, `too_few_markets`, or `sample_mismatch`). |
| `rows[].edge_hold` | Set when a measured edge is set aside, and the wallet is then listed after the ranked ones on the `edge` sort. `category_loss`: its realized P\&L in the sport is zero or below. `record_incomplete`: its recorded P\&L is more than 5% of its cost above Polymarket's figure, so settled losses are likely missing. |
| `rows[].pnl`, `cost`, `roi` | Realized P\&L, cost, and return on cost in the sport or league. `roi` is a fraction: `0.12` is 12%. |
| `rows[].volume` | See `volume_scope`. `null` on every league board row: no per-league volume is stored. |
| `rows[].category_numbers` | Whether the row's figures include the wallet's latest settlements. `state` is `current`, `behind` or `unknown`. `behind`: an update for the wallet has waited over an hour, and `as_of` is when the oldest waiting one was queued; the row keeps its rank and figures. `unknown`: 0xinsider's check has no recent result, so treat the figures as unverified, not current. `as_of` is `null` unless `state` is `behind`. |

## Example

```bash theme={null}
curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/leaderboard/sports/soccer?league=premier-league&sort=pnl&limit=10"
```

## 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.


## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.0xinsider.com/llms.txt).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.