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"
const response = await fetch('https://api.cryptohopper.com/v1/tournaments/leaderboard/YEAR', {
method: 'GET',
headers: {
"access-token": "YOUR_ACCESS_TOKEN"
}
});
const data = await response.json();
import requests
response = requests.get(
"https://api.cryptohopper.com/v1/tournaments/leaderboard/YEAR",
headers={
"access-token": "YOUR_ACCESS_TOKEN"
},
)
data = response.json()
$ch = curl_init('https://api.cryptohopper.com/v1/tournaments/leaderboard/YEAR');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'access-token: YOUR_ACCESS_TOKEN',
],
]);
$data = json_decode(curl_exec($ch), true);
Parameters
Headers
| Name | Type | Required | Description |
|---|---|---|---|
access-token |
string | Required | The OAuth access token of the user. |
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
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
{
"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"
}
]
}