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

# Leaderboard leagues

> List every league that has its own skill leaderboard, grouped by sport.

Use this endpoint to find out which leagues have a board before you ask for one. Each row's `sport` and `slug` are the `{sport}` path segment and the `league` value of [Sport leaderboard](https://docs.0xinsider.com/api-reference/endpoint/get-sport-leaderboard.md).

Leagues are grouped by sport, then sorted by the number of ranked wallets, most first. A league is listed once its edge ranking holds at least `min_ranked` wallets. It needs a Pro or Max key.

## Parameters

This endpoint takes no parameters.

## Key response fields

| Field | Meaning |
| - | - |
| `min_ranked` | The number of ranked wallets a league needs before it gets a board. |
| `min_resolved` | The number of resolved markets a wallet needs in a league to be on its board. |
| `refreshed_at` | When the league ranking last ran. Leagues are ranked once a day. |
| `leagues[].category` | The sport the league belongs to, for example `Soccer`. |
| `leagues[].sport` | The sport slug. Use it as the `{sport}` path segment of the board. |
| `leagues[].slug` | The league slug. Use it as the board's `league` value. |
| `leagues[].name` | The league's display name, for example `Premier League`. |
| `leagues[].ranked_traders` | The number of wallets the league's edge ranking holds. |
| `leagues[].total_traders` | The number of wallets with at least `min_resolved` resolved markets in the league. |

## Example

```bash theme={null}
curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/leaderboard/leagues"
```

## What it does not return

* The boards themselves. Read one with [Sport leaderboard](https://docs.0xinsider.com/api-reference/endpoint/get-sport-leaderboard.md).
* A league with too few ranked wallets. It has no board, so it is not listed.
* A ranking while the daily run is rebuilding it. The endpoint returns `503` `read_model_warming` with `Retry-After` instead.


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