Aanroepen en Retouren (REST API)

Laatst bijgewerkt: 31 mrt 2025

Aanroepen


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

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

Voor aanroepen van privé-endpoints moeten de volgende HTTP-headers worden opgegeven: apiKey en
authent. Het opnemen van de nonce in het verzoek is optioneel.

Voorbeeld

Het volgende toont een voorbeeld voor het opnemen 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.


Aanroepen van endpoints die de status van de server niet wijzigen, moeten worden ingediend met requestType
= GET en met postData dat in de URL wordt ingediend. Aanroepen van endpoints die de status van de server wel wijzigen, moeten worden ingediend met requestType = POST en met postData dat in de URL wordt ingediend. Sectie 4 beschrijft voor elk endpoint welk requestType moet worden gebruikt.

Retouren


De retouren van de API zijn in JSON-formaat. Als de aanroep succesvol was, bevat de retour de gevraagde
informatie of feedback over de gevraagde actie. Zie Sectie Error! Reference source not found. voor een beschrijving van retouren voor elk endpoint.

Als een aanroep succesvol was, zal de result-sleutel in de rootstructuur de waarde success hebben.

Voor aanroepen van privé-endpoints moeten de volgende HTTP-headers worden opgegeven: apiKey en
authent.

Voorbeeld

Het volgende toont de retour van een succesvolle aanroep van 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"
}
}


Merk op dat als een aanroep terugkomt met resultaat gelijk aan success, dit slechts betekent dat het verzoek succesvol is ontvangen en beoordeeld. Het betekent niet noodzakelijkerwijs dat de gewenste bewerking is uitgevoerd. Details over de status van de bewerking worden, indien van toepassing, geretourneerd in een status-sleutel.

Voorbeeld

Het volgende toont de retour van een succesvolle aanroep van 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"
}
}

Meer hulp nodig?