Calls en responses (REST API)

Laatst bijgewerkt: 7 oktober 2026

Oproepen


Om toegang te krijgen tot de endpoints van de API, moeten HTTP-calls worden verstuurd naar de volgende URL.

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

Voor calls naar privé-endpoints moeten de volgende HTTP-headers worden meegestuurd: apiKey en
authent. De Nonce in het verzoek is optioneel.

Bijvoorbeeld

Hieronder staat een voorbeeld van het meesturen van HTTP-headers in Java. Voor volledige
werkende voorbeelden in verschillende programmeertalen, zie Sectie Voorbeeldimplementaties. 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); waarbij apiKey en authent worden bepaald zoals eerder beschreven.


Calls naar endpoints die de toestand van de server niet wijzigen, moeten worden ingediend met requestType
= GET, met postData in de URL. Calls naar endpoints die de toestand van de server wél wijzigen, moeten worden ingediend met requestType = POST, met postData in de URL. Sectie 4 beschrijft per endpoint welk requestType gebruikt moet worden.

Rendementen


De responses van de API zijn in JSON-formaat. Als de call succesvol was, bevat de response de gevraagde
informatie of feedback over de gevraagde actie. Zie Sectie Fout! Verwijzingsbron niet gevonden. voor een beschrijving van de responses per endpoint.

Als een call succesvol was, heeft de result-sleutel in de rootstructuur de waarde success.

Voor calls naar privé-endpoints moeten de volgende HTTP-headers worden meegestuurd: apiKey en
authent.

Bijvoorbeeld

Hieronder staat de response van een succesvolle call naar het sendorder-endpoint.
{
"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"
}
}


Let op: als een call terugkomt met result gelijk aan success, betekent dit alleen dat het verzoek succesvol is ontvangen en verwerkt. Dit betekent niet per se dat de gewenste bewerking is
uitgevoerd. Details over de status van de bewerking worden, indien van toepassing, teruggegeven in een status-sleutel.

Bijvoorbeeld

Hieronder staat de response van een succesvolle call naar het sendorder-endpoint waarbij de gewenste bewerking niet is uitgevoerd. {
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"insufficientAvailableFunds"
}
}