Kald og returneringer (REST API)

Sidst opdateret: 31. marts 2025

Kald


For at få adgang til API'ets endepunkter skal HTTP-kald sendes til følgende URL.

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

For kald af private endepunkter skal følgende HTTP-headers angives: apiKey og
authent. Det er valgfrit at inkludere nonce i anmodningen.

Eksempel

Følgende viser et eksempel på inkludering af HTTP-headers i Java. For komplette
arbejdseksempler på forskellige programmeringssprog, se afsnittet 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 af endepunkter, der ikke ændrer serverens tilstand, skal sendes med requestType
= GET og med postData indsendt i URL'en. Kald af endepunkter, der ændrer serverens tilstand, skal sendes med requestType = POST og med postData indsendt i URL'en. Afsnit 4 beskriver for hvert endepunkt, hvilken requestType der skal bruges.

Returneringer


API'ets returneringer er i JSON-format. Hvis kaldet var vellykket, inkluderer returneringen den anmodede
information eller feedback om den anmodede handling. Se afsnit Error! Reference source not found. for en beskrivelse af returneringer for hvert endepunkt.

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

For kald af private endepunkter skal følgende HTTP-headers angives: apiKey og
authent.

Eksempel

Følgende viser returneringen af et vellykket kald af sendorder-endepunktet.
{
"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 med result lig med success, betyder det blot, at anmodningen er
modtaget og vurderet med succes. Det betyder ikke nødvendigvis, at den ønskede handling er udført. Detaljer om handlingens status returneres i en status-nøgle, hvor det er relevant.

Eksempel

Følgende viser returneringen af et vellykket kald af sendorder-endepunktet, 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"
}
}

Har du brug for mere hjælp?