Kutsut ja vastaukset (REST API)

Viimeksi päivitetty: 7. lokakuuta 2026

Kutsut


API:n päätepisteisiin pääsee lähettämällä HTTP-kutsuja seuraavaan URL-osoitteeseen.

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

Yksityisten päätepisteiden kutsut edellyttävät seuraavia HTTP-otsikoita: apiKey ja
authent. Nonce on valinnainen pyynössä.

Esimerkki

Alla on esimerkki HTTP-otsikoiden lisäämisestä Java-koodiin. Toimivia esimerkkejä eri
ohjelmointikielillä löytyy osiosta Esimerkkitoteutukset. 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); Arvot apiKey ja authent määräytyvät aiemmin kuvatulla tavalla.


Päätepisteiden kutsut, jotka eivät muuta palvelimen tilaa, on lähetettävä requestType-arvolla
= GET ja postData URL:n mukana. Päätepisteiden kutsut, jotka muuttavat palvelimen tilaa, on lähetettävä requestType-arvolla = POST ja postData URL:n mukana. Osio 4 erittelee kunkin päätepisteen oikean requestType-arvon.

Tuotot


API:n vastaukset ovat JSON-muodossa. Onnistuneen kutsun vastaus sisältää pyydetyt
tiedot tai palautteen pyydetystä toiminnosta. Kunkin päätepisteen vastausten kuvaus löytyy osiosta Virhe! Viitelähdettä ei löydy.

Jos kutsu onnistui, juurirakenteen result-avaimella on arvo success.

Yksityisten päätepisteiden kutsuja varten seuraavat HTTP-otsikot on annettava: apiKey ja
authent.

Esimerkki

Alla on esimerkki sendorder-päätepisteen onnistuneen kutsun vastauksesta.
{
"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"
}
}


Huomaa, että jos kutsun vastauksessa result on success, se tarkoittaa ainoastaan, että pyyntö on
vastaanotettu ja käsitelty onnistuneesti. Se ei välttämättä tarkoita, että haluttu toiminto on suoritettu. Toiminnon tila palautetaan status-avaimessa tarvittaessa.

Esimerkki

Alla näkyy onnistuneen sendorder-päätepisteen kutsun vastaus tilanteessa, jossa haluttua toimintoa ei suoritettu. {
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"insufficientAvailableFunds"
}
}