# Get the tournament leaderboard of a year

`GET https://api.cryptohopper.com/v1/tournaments/leaderboard/{year}`

Part of [Tournaments](https://www.cryptohopper.com/api-documentation/api-reference/tournaments.md) in the Cryptohopper API reference.

Returns the top 100 players of the tournament leaderboard of one year, ordered by rank.

OAuth scope: `read`

## Headers

| Name | Type | Required | Description |
|---|---|---|---|
| `access-token` | string | yes | The OAuth access token of the user. |

## Path parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `year` | string | yes | Four digit year, from 2021 up to next year, or all for the all time leaderboard. A year outside that range returns an empty list; a non-numeric value other than all falls back to the current year. |

## Example request

```bash
curl "https://api.cryptohopper.com/v1/tournaments/leaderboard/YEAR" \
  -H "access-token: YOUR_ACCESS_TOKEN"
```

## Response

Example response (illustrative values):

```json
{
    "data": [
        {
            "score": "2310",
            "rank": "1",
            "name": "Trader Jane",
            "alias": "trader-jane",
            "player_id": "4567",
            "logo": "https://cdn.example.com/images/social/uploads/avatar_4567.jpg"
        }
    ]
}
```

Status codes: 200. Errors return JSON with `status`, `error` and `message`, plus a numeric `code` when the error comes from the API itself rather than the gateway.