Wywołania i zwroty (REST API)

Ostatnia aktualizacja: 31 mar 2025

Wywołania


Aby uzyskać dostęp do punktów końcowych API, należy wysyłać wywołania HTTP na następujący adres URL.

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

W przypadku wywołań prywatnych punktów końcowych należy podać następujące nagłówki HTTP: apiKey i
authent. Dołączenie wartości nonce do żądania jest opcjonalne.

Przykład

Poniżej przedstawiono przykład dołączenia nagłówków HTTP w Javie. Pełne
działające przykłady w różnych językach programowania można znaleźć w sekcji Przykładowe implementacje. 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); gdzie apiKey i authent są określane zgodnie z wcześniejszym opisem.


Wywołania punktów końcowych, które nie zmieniają stanu serwera, powinny być przesyłane z requestType
= GET i z postData przesyłanymi w adresie URL. Wywołania punktów końcowych, które zmieniają stan serwera, powinny być przesyłane z requestType = POST i z postData przesyłanymi w adresie URL. Sekcja 4 szczegółowo opisuje dla każdego punktu końcowego, który requestType powinien być użyty.

Zwroty


Zwroty API są w formacie JSON. Jeśli wywołanie zakończyło się sukcesem, zwrot zawiera żądane
informacje lub opinię na temat żądanej akcji. Opis zwrotów dla każdego punktu końcowego znajduje się w sekcji Błąd! Nie znaleziono źródła odniesienia.

Jeśli wywołanie zakończyło się sukcesem, klucz result w strukturze głównej będzie miał wartość success.

W przypadku wywołań prywatnych punktów końcowych należy podać następujące nagłówki HTTP: apiKey i
authent.

Przykład

Poniżej przedstawiono zwrot udanego wywołania punktu końcowego 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"
}
}


Należy pamiętać, że jeśli wywołanie zwraca wynik równy success, oznacza to jedynie, że żądanie zostało
pomyślnie odebrane i ocenione. Nie oznacza to koniecznie, że żądana operacja została wykonana. Szczegóły dotyczące statusu operacji są zwracane w kluczu status, jeśli ma to zastosowanie.

Przykład

Poniżej przedstawiono odpowiedź udanego wywołania punktu końcowego sendorder, w którym żądana operacja nie została wykonana. {
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"insufficientAvailableFunds"
}
}

Potrzebujesz więcej pomocy?