Kald og svar (REST API)

Senest opdateret: 7. oktober 2026

Call-optioner


For at tilgå API'ets slutpunkter skal der sendes HTTP-kald til følgende URL.

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

Ved kald til private slutpunkter skal følgende HTTP-headere angives: apiKey og
authent. Det er valgfrit at inkludere nonce i anmodningen.

Eksempel

Nedenfor ses et eksempel på, hvordan HTTP-headere inkluderes i Java. For fuldt
arbejdseksempler på forskellige programmeringssprog, se afsnit Eksempelimplementeringer. 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); hvor apiKey og authent bestemmes som beskrevet tidligere.


Kald til slutpunkter, der ikke ændrer serverens tilstand, skal sendes med requestType
= GET, og postData skal angives i URL'en. Kald til slutpunkter, der ændrer serverens tilstand, skal sendes med requestType = POST, og postData skal angives i URL'en. Afsnit 4 angiver for hvert slutpunkt, hvilken requestType der skal anvendes.

Returneringer


API'ets svar er i JSON-format. Hvis kaldet lykkes, indeholder svaret de ønskede
oplysninger eller feedback om den anmodede handling. Se afsnit Fejl! Referencekilde ikke fundet. for en beskrivelse af svar for hvert slutpunkt.

Hvis et kald lykkes, vil result-nøglen i rodstrukturen have værdien success.

Ved kald til private slutpunkter skal følgende HTTP-headere angives: apiKey og
authent.

Eksempel

Nedenfor ses svaret på et vellykket kald til sendorder-slutpunktet.
{
"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"
}
}


Bemærk, at hvis et kald returnerer result lig med success, betyder det blot, at anmodningen er
modtaget og behandlet. Det betyder ikke nødvendigvis, at den ønskede handling er udført. Detaljer om handlingens status returneres i en status-nøgle, hvor relevant.

Eksempel

Nedenfor ses svaret på et vellykket kald til sendorder-slutpunktet, hvor den ønskede handling ikke blev udført. {
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"insufficientAvailableFunds"
}
}