Kutsut ja palautukset (REST API)

Viimeksi päivitetty: 31.3.2025

Kutsut


API:n päätepisteiden käyttämiseksi HTTP-kutsut on lähetettävä seuraavaan URL-osoitteeseen.

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

Yksityisten päätepisteiden kutsuissa on annettava seuraavat HTTP-otsakkeet: apiKey ja
authent. Noncen sisällyttäminen pyyntöön on valinnaista.

Esimerkki

Seuraavassa on esimerkki HTTP-otsakkeiden sisällyttämisestä Javalla. Katso täydelliset
toimivat esimerkit eri ohjelmointikielillä 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); jossa apiKey ja authent määritetään aiemmin kuvatulla tavalla.


Päätepisteiden kutsut, jotka eivät muuta palvelimen tilaa, tulee lähettää käyttäen requestType
= GET ja postData-tiedot URL-osoitteessa. Päätepisteiden kutsut, jotka muuttavat palvelimen tilaa, tulee lähettää käyttäen requestType = POST ja postData-tiedot URL-osoitteessa. Osiossa 4 kerrotaan kunkin päätepisteen osalta, mitä requestType-tyyppiä tulee käyttää.

Palautukset


API:n palautukset ovat JSON-muodossa. Jos kutsu onnistui, palautus sisältää pyydetyt
tiedot tai palautetta pyydetystä toiminnosta. Katso osio Error! Reference source not found. kunkin päätepisteen palautusten kuvauksesta.

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

Yksityisten päätepisteiden kutsuissa on annettava seuraavat HTTP-otsakkeet: apiKey ja
authent.

Esimerkki

Seuraavassa näkyy sendorder-päätepisteen onnistuneen kutsun palautus.
{
"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 palauttama result on success, se tarkoittaa ainoastaan, että pyyntö on
vastaanotettu ja arvioitu onnistuneesti. Se ei välttämättä tarkoita, että haluttu toiminto on suoritettu. Tiedot toiminnon tilasta palautetaan status-avaimessa, jos sovellettavissa.

Esimerkki

Seuraavassa näkyy sendorder-päätepisteen onnistuneen kutsun palautus 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"
}
}

Tarvitsetko lisää apua?