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

# Leaderboard

## Endpoint

```text theme={null}
POST /leaderboard
```

## Request Body

| Parameter | Type   | Description                           |
| --------- | ------ | ------------------------------------- |
| `period`  | string | One of `24H`, `7D`, `30D`, `All-Time` |

## Response

```json theme={null}
{
  "entries": [
    {
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "accountValue": "12500.00",
      "pnl": "1000.00",
      "roi": "8.70",
      "volume": "50000.00",
      "hasGenesisBadge": true
    }
  ],
  "metadata": {
    "period": "All-Time",
    "computedAtMs": 1781568000000,
    "periodStartMs": 0,
    "periodEndMs": 1781568000000
  }
}
```

### Response Fields

| Field      | Type   | Description                                     |
| ---------- | ------ | ----------------------------------------------- |
| `entries`  | array  | Leaderboard entries ordered by trading volume   |
| `metadata` | object | Snapshot metadata for the requested time period |

### Entry Fields

| Field             | Type            | Description                                                                         |
| ----------------- | --------------- | ----------------------------------------------------------------------------------- |
| `address`         | string          | Wallet address                                                                      |
| `accountValue`    | string          | Current account value                                                               |
| `pnl`             | string          | Realized plus unrealized performance for the selected period                        |
| `roi`             | string          | Return percentage for the selected period                                           |
| `volume`          | string          | Trading volume tracked for the entry                                                |
| `hasGenesisBadge` | boolean \| null | Whether the trader can publicly display the Genesis badge, or `null` if unavailable |

### Metadata Fields

| Field           | Type           | Description                                  |
| --------------- | -------------- | -------------------------------------------- |
| `period`        | string         | Requested leaderboard period                 |
| `computedAtMs`  | number \| null | Snapshot timestamp in milliseconds           |
| `periodStartMs` | number \| null | Start of the selected period in milliseconds |
| `periodEndMs`   | number \| null | End of the selected period in milliseconds   |

## Notes

<Note>
  * Default period is `All-Time`. - Entries are ordered by `volume` descending, then `pnl`
    descending. - Responses are backed by the follower read replica in production.
</Note>