## Global XP leaderboard

**get** `/api/v1/leaderboard`

Returns the top users platform-wide, ranked by XP descending.

### Query Parameters

- `limit: optional number`

  Max results (1–100, default 25)

### Returns

- `entries: optional array of LeaderboardEntry`

  - `image: optional string`

  - `name: optional string`

  - `rank: optional number`

  - `streakDays: optional number`

  - `username: optional string`

  - `xp: optional number`

### Example

```http
curl https://racks.cash/api/v1/leaderboard
```

#### Response

```json
{
  "entries": [
    {
      "image": "image",
      "name": "Alice",
      "rank": 1,
      "streakDays": 12,
      "username": "alice",
      "xp": 9800
    }
  ]
}
```