Calls und Returns (REST API)

Zuletzt aktualisiert: 7. Oktober 2026

Calls


Um auf die Endpunkte der API zuzugreifen, müssen HTTP-Anfragen an die folgende URL gesendet werden.

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

Für Anfragen an private Endpunkte müssen die folgenden HTTP-Header angegeben werden: apiKey und
authent. Die Angabe der Nonce in der Anfrage ist optional.

Beispiel

Das folgende Beispiel zeigt die Einbindung von HTTP-Headern in Java. Vollständige
Beispiele in verschiedenen Programmiersprachen findest du in Abschnitt Beispielimplementierungen. 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); wobei apiKey und authent wie zuvor beschrieben ermittelt werden.


Anfragen an Endpunkte, die den Serverstatus nicht verändern, sollten mit requestType
= GET und mit in der URL übermittelten postData gesendet werden. Anfragen an Endpunkte, die den Serverstatus verändern, sollten mit requestType = POST und mit in der URL übermittelten postData gesendet werden. Abschnitt 4 gibt für jeden Endpunkt an, welcher requestType zu verwenden ist.

Returns


Die API-Antworten werden im JSON-Format zurückgegeben. Bei einer erfolgreichen Anfrage enthält die Antwort die angeforderten
Informationen oder eine Rückmeldung zur angeforderten Aktion. Eine Beschreibung der Antworten für jeden Endpunkt findest du in Abschnitt Fehler! Referenzquelle nicht gefunden.

Bei einer erfolgreichen Anfrage hat der result-Schlüssel in der Hauptstruktur den Wert success.

Für Anfragen an private Endpunkte müssen die folgenden HTTP-Header angegeben werden: apiKey und
authent.

Beispiel

Im folgenden siehst du den Return eines erfolgreichen Calls des Endpunkts „sendorder“.
{
"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"
}
}


Hinweis: Gibt eine Anfrage result gleich success zurück, bedeutet dies lediglich, dass die Anfrage
erfolgreich empfangen und verarbeitet wurde. Dies bedeutet nicht zwangsläufig, dass die gewünschte Operation ausgeführt wurde. Details zum Status der Operation werden, sofern zutreffend, in einem status-Schlüssel zurückgegeben.

Beispiel

Das folgende Beispiel zeigt die Antwort einer erfolgreichen Anfrage an den sendorder-Endpunkt, bei der die gewünschte Operation nicht ausgeführt wurde. {
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"insufficientAvailableFunds"
}
}