Aufrufe und Rückgaben (REST API)

Zuletzt aktualisiert: 31. März 2025

Aufrufe


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

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

Für Aufrufe privater Endpunkte müssen die folgenden HTTP-Header bereitgestellt werden: apiKey und
authent. Das nonce in der Anfrage ist optional.

Beispiel

Das Folgende zeigt ein Beispiel für die Einbindung von HTTP-Headern in Java. Vollständige
funktionierende Beispiele in verschiedenen Programmiersprachen finden Sie im 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 bestimmt werden.


Aufrufe von Endpunkten, die den Zustand des Servers nicht ändern, sollten mit requestType
= GET und mit postData in der URL übermittelt werden. Aufrufe von Endpunkten, die den Zustand des Servers ändern, sollten mit requestType = POST und mit postData in der URL übermittelt werden. Abschnitt 4 beschreibt für jeden Endpunkt, welcher requestType verwendet werden sollte.

Rückgaben


Die Rückgaben der API erfolgen im JSON-Format. War der Aufruf erfolgreich, enthält die Rückgabe die angeforderten
Informationen oder ein Feedback zur angeforderten Aktion. Eine Beschreibung der Rückgaben für jeden Endpunkt finden Sie im Abschnitt Error! Reference source not found.

War ein Aufruf erfolgreich, hat der result-Schlüssel in der Root-Struktur den Wert success.

Für Aufrufe privater Endpunkte müssen die folgenden HTTP-Header bereitgestellt werden: apiKey und
authent.

Beispiel

Das Folgende zeigt die Rückgabe eines erfolgreichen Aufrufs des sendorder-Endpunkts.
{
"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"
}
}


Beachten Sie, dass, wenn ein Aufruf mit result gleich success zurückkommt, dies lediglich bedeutet, dass die Anfrage erfolgreich empfangen und bewertet wurde. Es bedeutet nicht unbedingt, dass die gewünschte Operation durchgeführt wurde. Details zum Status der Operation werden gegebenenfalls in einem status-Schlüssel zurückgegeben.

Beispiel

Das Folgende zeigt die Rückgabe eines erfolgreichen Aufrufs des sendorder-Endpunkts, bei dem die gewünschte Operation nicht durchgeführt wurde. {
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"insufficientAvailableFunds"
}
}

Brauchst du weitere Hilfe?