Kall og responser (REST API)

Sist oppdatert: 7. oktober 2026

Calls


For å få tilgang til API-ens endepunkter må HTTP-kall sendes til følgende URL.

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

For kall til private endepunkter må følgende HTTP-hoder oppgis: apiKey og
authent. Nonce er valgfritt å inkludere i forespørselen.

Eksempel

Nedenfor vises et eksempel på inkludering av HTTP-hoder i Java. For fullstendige
arbeidseksempler i ulike programmeringsspråk, se avsnitt Eksempelimplementasjoner. 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); der apiKey og authent bestemmes som beskrevet tidligere.


Kall til endepunkter som ikke endrer serverens tilstand skal sendes med requestType
= GET og med postData i URL-en. Kall til endepunkter som endrer serverens tilstand skal sendes med requestType = POST og med postData i URL-en. Avsnitt 4 angir hvilken requestType som skal brukes for hvert endepunkt.

Avkastning


API-ens responser er i JSON-format. Hvis kallet var vellykket, inneholder responsen den forespurte
informasjonen eller tilbakemeldingen på den forespurte handlingen. Se avsnitt Feil! Referansekilde ikke funnet for en beskrivelse av responser for hvert endepunkt.

Hvis et kall var vellykket, vil result-nøkkelen i rotstrukturen ha verdien success.

For kall til private endepunkter må følgende HTTP-hoder oppgis: apiKey og
authent.

Eksempel

Nedenfor vises responsen fra et vellykket kall til 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"
}
}


Merk at hvis et kall returnerer result lik success, betyr dette bare at forespørselen er
mottatt og behandlet uten feil. Det betyr ikke nødvendigvis at den ønskede operasjonen er utført. Detaljer om operasjonens status returneres i en status-nøkkel der dette er aktuelt.

Eksempel

Nedenfor vises responsen fra et vellykket kall til sendorder-endepunktet der den ønskede operasjonen ikke ble utført. {
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"insufficientAvailableFunds"
}
}