Volání a odpovědi (REST API)

Naposledy aktualizováno: 7. října 2026

Kupní opce


Pro přístup ke koncovým bodům API je nutné odesílat HTTP žádosti na následující URL.

https://futures.kraken.com/derivatives/api/v3

Pro volání privátních koncových bodů je nutné uvést tyto HTTP hlavičky: apiKey a
authent. Zahrnutí nonce do žádosti je volitelné.

Příklad

Níže je uveden příklad zahrnutí HTTP hlaviček v Javě. Plně funkční příklady v různých programovacích jazycích najdete v části Sample Implementations. String url = "https://futures.kraken.com/derivatives/api/v3/sendOrder";
working examples in different programming languages, see Section Sample Implementations. String url = "https://futures.kraken.com/derivatives/api/v3/sendOrder";
URL obj = new URL(url);
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
...
con.setRequestProperty("APIKey", apiKey);
con.setRequestProperty("Authent", authent); kde apiKey a authent jsou určeny způsobem popsaným výše.


Žádosti na koncové body, které nemění stav serveru, se odesílají s requestType
= GET a s postData předanými v URL. Žádosti na koncové body, které stav serveru mění, se odesílají s requestType = POST a s postData předanými v URL. Část 4 uvádí pro každý koncový bod, jaký requestType se má použít.

Vráceno


Odpovědi API jsou ve formátu JSON. Proběhlo-li volání úspěšně, odpověď obsahuje požadované
informace nebo zpětnou vazbu k požadované akci. Popis odpovědí pro jednotlivé koncové body najdete v části Chyba! Zdroj odkazu nenalezen.

Proběhlo-li volání úspěšně, klíč result v kořenové struktuře bude mít hodnotu success.

Pro volání privátních koncových bodů je nutné uvést tyto HTTP hlavičky: apiKey a
authent.

Příklad

Níže je zobrazena odpověď na úspěšné volání koncového bodu sendorder.
{
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"placed",
"order_id":"c18f0c17-9971-40e6-8e5b10df05d422f0"
}
}


Mějte na paměti, že výsledek success u volání znamená pouze to, že žádost byla
přijata a úspěšně vyhodnocena. Neznamená to nutně, že požadovaná operace byla provedena. Podrobnosti o stavu operace jsou tam, kde je to relevantní, vráceny v klíči status.

Příklad

Níže je zobrazena odpověď na úspěšné volání koncového bodu sendorder, při kterém požadovaná operace nebyla provedena. {
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"insufficientAvailableFunds"
}
}