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

# Category leaderboard

> Get one sport's wallets ranked by how surely they beat the prices they paid.

Use this endpoint for the wallets with a proven edge in one sport or in esports. It returns the board the category pages on 0xinsider.com show, for example `/categories/soccer`. It needs a Pro or Max key.

For every category's top three in one read, use [Category leaders](https://docs.0xinsider.com/api-reference/endpoint/list-category-leaders.md). To rank one sport by edge, P\&L, or win rate over settled markets, use [Sport leaderboard](https://docs.0xinsider.com/api-reference/endpoint/get-sport-leaderboard.md).

## How it ranks

Each wallet's edge is how much more often its side won than the prices it paid implied, measured over independent events in the category. The board ranks `edge_lower_bound`, the 95% lower bound of that edge, so a short lucky record does not rank first. Only wallets whose lower bound is above zero are listed. Ties go to the wallet with more `independent_events`.

## Parameters

| Parameter | Description |
| - | - |
| `slug` | Required, in the path. A category slug, for example `soccer`, `basketball`, `tennis`, or `esports`. A slug outside sports and esports returns `404` with `error.param` `slug`. |
| `active_within` | Optional. `all` (the default), `7d`, `30d`, or `90d`. Keeps only the wallets that traded in the category within that window. Any other value returns `400` with `error.param` `active_within`. |
| `min_events` | Optional. The number of independent events a wallet needs in the category to be listed. The default is 0. The website offers 50, 100, and 250. |
| `limit` | Optional. The number of rows per page, from 1 to 100. The default is 20. |
| `cursor` | Optional. The `next_cursor` from the previous page. |

## Key response fields

| Field | Meaning |
| - | - |
| `data[].rank` | The wallet's position in the category, 1 first. |
| `data[].category` | The category name, for example `Soccer`. |
| `data[].id` | The wallet's trader ID, `trd_0x...`. |
| `data[].grade` | The wallet's 0xinsider grade. `null` when the wallet is unranked. |
| `data[].edge_lower_bound` | The ranking value: the 95% lower bound of the wallet's edge, as a fraction. `0.05` is 5 percentage points. |
| `data[].independent_events` | The independent events the edge is measured over. |
| `data[].unresolved_events` | The wallet's positions in the category that are still waiting for a result. |
| `data[].n_resolved`, `win_rate` | The wallet's resolved markets in the category, and the share it made money on, from 0 to 1. |
| `data[].pnl` | Realized P\&L across those resolved markets, in USD. |
| `data[].as_of` | When the wallet's ranking was last computed. |
| `data[].category_numbers` | Whether `n_resolved`, `win_rate` and `pnl` 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. `unknown`: 0xinsider's check has no recent result, so treat the figures as unverified, not current. `as_of` is `null` unless `state` is `behind`. |
| `total` | The number of listed wallets across every page for these filters. |

## Paging

Pass `next_cursor` as `cursor` until `has_more` is `false`. The ranking is recomputed about once an hour. A cursor issued before a recompute returns `400` with `error.reason` `cursor_expired`: start again from the first page. A cursor from another `slug`, `active_within`, or `min_events` returns `400` with `error.param` `cursor`.

## Example

```bash theme={null}
curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/leaderboard/categories/soccer?active_within=30d&min_events=50"
```

## What it does not return

* Wallets whose edge lower bound is zero or below. `total` counts only the listed wallets.
* The model's other figures, such as its mean, spread, or calibration scores.
* 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 page 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.