Vývojáři
POST
https://api.cryptohopper.com/v1/tournaments/search
Searches published tournaments by name and description. Only tournaments that end later than one day ago are searched.
OAuth scope:
read About scopes
search is required. start is a row offset (default 0) and limit the number of results (1 to 100, default 100). Returns {"data": null} when nothing matches.
Example request
curl -X POST "https://api.cryptohopper.com/v1/tournaments/search" \
-H "access-token: YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"search":"USDT","start":0,"limit":20}'const response = await fetch('https://api.cryptohopper.com/v1/tournaments/search', {
method: 'POST',
headers: {
"access-token": "YOUR_ACCESS_TOKEN",
"Content-Type": "application/json"
},
body: JSON.stringify({
"search": "USDT",
"start": 0,
"limit": 20
})
});
const data = await response.json();import requests
response = requests.post(
"https://api.cryptohopper.com/v1/tournaments/search",
headers={
"access-token": "YOUR_ACCESS_TOKEN"
},
json={
"search": "USDT",
"start": 0,
"limit": 20
},
)
data = response.json()$ch = curl_init('https://api.cryptohopper.com/v1/tournaments/search');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'access-token: YOUR_ACCESS_TOKEN',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'search' => 'USDT',
'start' => 0,
'limit' => 20,
]),
]);
$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",
"players": "87"
}
]
}