Volání a návratové hodnoty (REST API)

Naposledy aktualizováno: 31. března 2025

Volání


Pro přístup k endpointům API je třeba odesílat HTTP volání na následující URL.

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

Pro volání soukromých endpointů musí být poskytnuty následující HTTP hlavičky: apiKey a
authent. Zahrnutí nonce do požadavku je volitelné.

Příklad

Následující ukazuje příklad zahrnutí HTTP hlaviček v Javě. Úplné
funkční příklady v různých programovacích jazycích naleznete v sekci Ukázkové implementace. 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, jak bylo popsáno dříve.


Volání endpointů, které nemění stav serveru, by měla být odesílána s requestType
= GET a s postData odesílanými v URL. Volání endpointů, které mění stav serveru, by měla být odesílána s requestType = POST a s postData odesílanými v URL. Sekce 4 podrobně popisuje pro každý endpoint, jaký requestType by měl být použit.

Návratové hodnoty


Návratové hodnoty API jsou ve formátu JSON. Pokud bylo volání úspěšné, návratová hodnota obsahuje požadované
informace nebo zpětnou vazbu k požadované akci. Popis návratových hodnot pro každý endpoint naleznete v sekci Chyba! Zdroj odkazu nenalezen.

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

Pro volání soukromých endpointů musí být poskytnuty následující HTTP hlavičky: apiKey a
authent.

Příklad

Následující ukazuje návratovou hodnotu úspěšného volání endpointu 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"
}
}


Všimněte si, že pokud se volání vrátí s result rovným success, znamená to pouze, že požadavek byl
úspěšně přijat a posouzen. Neznamená to nutně, že požadovaná operace byla provedena. Podrobnosti o stavu operace jsou vráceny v klíči status, je-li to relevantní.

Příklad

Následující ukazuje návratovou hodnotu úspěšného volání endpointu sendorder, kde požadovaná operace nebyla provedena. {
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"insufficientAvailableFunds"
}
}

Potřebujete další pomoc?