GET
https://api.cryptohopper.com/v1/tournaments
Returns all published tournaments that have not ended, plus those that ended in the last 3 days, ordered by start date.
OAuth scope:
read About scopes
Dates are in the format YYYY-MM-DD HH:MM:SS. links, config and prize_levels are JSON objects, or null when empty. tournament_type is market, quote, exchange, marketexchange, quoteexchange or all and decides which of exchange, quote and base apply. papertrading_type 1 means paper trading, 0 real funds.
Example request
curl "https://api.cryptohopper.com/v1/tournaments" \
-H "access-token: YOUR_ACCESS_TOKEN"
const response = await fetch('https://api.cryptohopper.com/v1/tournaments', {
method: 'GET',
headers: {
"access-token": "YOUR_ACCESS_TOKEN"
}
});
const data = await response.json();
import requests
response = requests.get(
"https://api.cryptohopper.com/v1/tournaments",
headers={
"access-token": "YOUR_ACCESS_TOKEN"
},
)
data = response.json()
$ch = curl_init('https://api.cryptohopper.com/v1/tournaments');
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. |
Response
{
"data": [
{
"id": "1501",
"price_id": "0",
"winner_id": "0",
"tournament_type": "quoteexchange",
"papertrading_type": "1",
"name": "Weekly USDT Challenge",
"logo": "https://cdn.example.com/images/tournaments/logo_1501.png",
"feature": "https://cdn.example.com/images/tournaments/feature_1501.png",
"description": "Trade USDT markets on Binance for one week.",
"tournament_terms": "Paper trading only. One hopper per player.",
"links": null,
"config": null,
"prize_levels": null,
"active_prize_level": "-1",
"new_prize_level": "-1",
"max_players": "0",
"exchange": "binance",
"quote": "USDT",
"base": "",
"start_date_join": "2026-09-21 00:00:00",
"end_date_join": "2026-10-04 00:00:00",
"start_date": "2026-09-28 00:00:00",
"end_date": "2026-10-05 00:00:00",
"updated": "2026-09-21 00:00:00",
"created": "2026-09-21 00:00:00",
"published": "1",
"top_tournament": "0",
"started": "0",
"ended": "0",
"recreated": "0",
"pinned": "0",
"leveraged_tokens": "0",
"total_players": "87"
}
]
}