Kall og returer (REST API)

Sist oppdatert: 31. mars 2025

Kall


For å få tilgang til API-ets 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-headere oppgis: apiKey og
authent. Det er valgfritt å inkludere nonce i forespørselen.

Eksempel

Følgende viser et eksempel på inkludering av HTTP-headere i Java. For fullstendige
fungerende eksempler på forskjellige programmeringsspråk, se avsnittet 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); der apiKey og authent bestemmes som beskrevet tidligere.


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

Returer


API-ets returer er i JSON-format. Hvis kallet var vellykket, inkluderer returen den forespurte
informasjonen eller tilbakemeldingen om den forespurte handlingen. Se avsnitt Feil! Referansekilde ikke funnet. for en beskrivelse av returer 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-headere oppgis: apiKey og
authent.

Eksempel

Følgende viser returen 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 med result lik success, betyr dette bare at forespørselen er mottatt og vurdert vellykket. Det betyr ikke nødvendigvis at den ønskede operasjonen er utført. Detaljer om operasjonens status returneres i en status-nøkkel, der det er aktuelt.

Eksempel

Følgende viser returen 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"
}
}

Trenger du mer hjelp?