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

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

OAuth scope: read About scopes

Example request

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

Parameters

Headers

NameTypeRequiredDescription
access-token string Required The OAuth access token of the user.

Path parameters

NameTypeRequiredDescription
year string Required 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.

Response

Example response (illustrative values)

{
    "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. See How the API works for response codes and rate limits.