Wywołania i odpowiedzi (REST API)

Ostatnia aktualizacja: 7 października 2026

Wywoływanie


Aby uzyskać dostęp do punktów końcowych API, należy wysyłać żądania HTTP pod 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 nonce do żądania jest opcjonalne.

Przykład

Poniżej przedstawiono przykład dołączania nagłówków HTTP w języku Java. Pełne przykłady robocze w różnych językach programowania znajdziesz w sekcji Przykładowe implementacje. String url = "https://futures.kraken.com/derivatives/api/v3/sendOrder";
działające przykłady w różnych językach programowania znajdziesz 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ą wyznaczane zgodnie z wcześniejszym opisem.


Żądania do punktów końcowych, które nie zmieniają stanu serwera, należy wysyłać z parametrem requestType
= GET, a postData przekazywać w adresie URL. Żądania do punktów końcowych, które zmieniają stan serwera, należy wysyłać z parametrem requestType = POST, a postData przekazywać w adresie URL. Sekcja 4 określa dla każdego punktu końcowego, jakiego requestType należy użyć.

Zwroty


Odpowiedzi API są w formacie JSON. W przypadku pomyślnego wywołania odpowiedź zawiera żądane informacje lub potwierdzenie wykonanej akcji. Opis odpowiedzi dla każdego punktu końcowego znajdziesz w sekcji
Błąd! Nie znaleziono źródła odniesienia.

Jeśli wywołanie zakończyło się pomyślnie, klucz result w strukturze głównej przyjmuje 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 odpowiedź dla pomyślnego 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 result równy success oznacza jedynie, że żądanie zostało poprawnie odebrane i przetworzone.
Nie oznacza to, że żądana operacja została wykonana. Szczegółowe informacje o statusie operacji są zwracane w kluczu status – jeśli dotyczy.

Przykład

Poniżej przedstawiono odpowiedź dla pomyślnego 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"
}
}