Anrop och returer (REST API)

Senast uppdaterad: 31 mars 2025

Anrop


För att komma åt API:ets slutpunkter måste HTTP-anrop skickas till följande URL.

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

För anrop till privata slutpunkter måste följande HTTP-huvuden anges: apiKey och
authent. Att inkludera nonce i begäran är valfritt.

Exempel

Följande visar ett exempel på inkludering av HTTP-huvuden i Java. För fullständiga
fungerande exempel på olika programmeringsspråk, se avsnittet Exempel på implementeringar. 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); där apiKey och authent bestäms som beskrivits tidigare.


Anrop till slutpunkter som inte ändrar serverns tillstånd ska skickas med requestType
= GET och med postData som skickas i URL:en. Anrop till slutpunkter som ändrar serverns tillstånd ska skickas med requestType = POST och med postData som skickas i URL:en. Avsnitt 4 beskriver för varje slutpunkt vilken requestType som ska användas.

Returer


API:ets returer är i JSON-format. Om anropet lyckades inkluderar returen den begärda
informationen eller feedback om den begärda åtgärden. Se avsnitt Error! Reference source not found. för en beskrivning av returer för varje slutpunkt.

Om ett anrop lyckades kommer nyckeln result i rotstrukturen att ha värdet success.

För anrop till privata slutpunkter måste följande HTTP-huvuden anges: apiKey och
authent.

Exempel

Följande visar returen från ett lyckat anrop till sendorder-slutpunkten.
{
"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"
}
}


Observera att om ett anrop returnerar med resultatet success, betyder detta endast att begäran har
mottagits och bedömts framgångsrikt. Det betyder inte nödvändigtvis att den önskade operationen har utförts. Detaljer om operationens status returneras i en status-nyckel, där det är tillämpligt.

Exempel

Följande visar returen från ett lyckat anrop till sendorder-slutpunkten där den önskade operationen inte utfördes. {
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"insufficientAvailableFunds"
}
}

Behöver du mer hjälp?