Get the leaderboard of a tournament

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

Returns the top 100 players of one tournament, ordered by score.

OAuth scope: read About scopes

player_id is the social profile ID of the player. The tournament is not checked for existence; an unknown ID returns an empty list.

Example request

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

Parameters

Headers

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

Path parameters

NameTypeRequiredDescription
tournament_id string Required Numeric ID of the tournament.

Response

Example response (illustrative values)

{
    "data": [
        {
            "score": "12.84",
            "alias": "trader-jane",
            "name": "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.