Jak utworzyć klucz API spot

Ostatnia aktualizacja: 8 sierpnia 2025

Klucze API są jednym z podstawowych elementów uwierzytelniania i bezpieczeństwa API; są one odpowiednikiem nazwy użytkownika i hasła Twojego konta Kraken w API.

Klucze API są wymagane do wywoływania dowolnych punktów końcowych API specyficznych dla konta (prywatnych), takich jak dane konta, handel, finansowanie i zarabianie. Klucze API nie są wymagane do wywoływania publicznych punktów końcowych API danych rynkowych, ponieważ punkty końcowe danych rynkowych nie są powiązane z żadnym konkretnym kontem Kraken.

Klucze API mogą być używane przez dowolne oprogramowanie, które wchodzi w interakcje z naszymi rynkami i kontami, takie jak nasze klienci wiersza poleceń REST API, mobilne aplikacje i platformy handlowe stron trzecich, boty handlowe stron trzecich oraz różne inne produkty/usługi.

•
Tworzenie klucza API
•
Konfiguracja klucza API (uprawnienia/ustawienia)
•
Bezpieczeństwo klucza API
•
Używanie klucza API
•
Konfiguracja uwierzytelniania dwuskładnikowego (2FA) klucza API

Tworzenie klucza API

•
Zaloguj się na konto Kraken na platformie Kraken Pro.
•
Otwórz menu konta (kliknij ikonę profilu w prawym górnym rogu strony).
•
Wybierz opcję Ustawienia.

•
Wybierz kartę API i kliknij opcję Utwórz klucz API.

Konfiguracja klucza API

Klucze API mają kilka ustawień i opcji, które muszą zostać skonfigurowane przed użyciem klucza API, w szczególności nazwę/opis i uprawnienia dostępu.

Opis klucza

Opis klucza jest w zasadzie nazwą klucza API i może być prawie dowolny, pod warunkiem, że opis jest unikalny (różny od opisów innych kluczy API na tym samym koncie).

Domyślnie opis klucza zostanie wypełniony czymś w rodzaju "api-key-1605316109249". Ten domyślny opis można zachować lub zmienić na bardziej opisową nazwę (taką jak "Klucz handlowy", "Klucz do zarządzania kontem", "Klucz API Python 6" lub "Klucz aplikacji mobilnej", na przykład).

Uprawnienia klucza

Uprawnienia klucza określają, które punkty końcowe API specyficzne dla konta (prywatne) dany klucz API może wywoływać:

Środki

•
Zapytanie o środki jest wymagane dla punktów końcowych API, które wysyłają zapytania o informacje o saldzie konta, takie jak Balance i TradeBalance.
•
Wpłać środki jest wymagane dla punktów końcowych finansowania związanych z wpłatami, takich jak DepositMethods i DepositAddresses.
•
Wypłać środki jest wymagane dla punktów końcowych finansowania związanych z wypłatą, takich jak WithdrawInfo, Withdraw i WithdrawCancel.

Zlecenia i transakcje

•
Zapytanie o otwarte zlecenia i transakcje jest wymagane dla punktów końcowych API, które odpytują już istniejące zlecenia i pozycje margin, takie jak OpenOrders, QueryOrders i OpenPositions.
•
Zapytanie o zamknięte zlecenia i transakcje jest wymagane dla punktów końcowych, które odpytują wcześniej zamknięte/anulowane zlecenia i pozycje margin, takie jak ClosedOrders, QueryOrders i QueryTrades.
•
Modyfikuj zlecenia jest wymagane dla punktów końcowych transakcji, które składają nowe zlecenia, takich jak AddOrder, EditOrder i AddOrderBatch.
•
Anuluj/zamknij zlecenia jest wymagane dla punktów końcowych transakcji, które anulują otwarte lub oczekujące zlecenia, takie jak CancelOrder, CancelAll i CancelOrderBatch.

Inne

•
Zapytanie o wpisy w rejestrze jest wymagane dla punktów końcowych API, które pobierają historyczne dane z rejestru konta, a mianowicie Ledgers i QueryLedgers.
•
Eksportuj dane jest wymagane dla punktów końcowych, które eksportują (pobierają) rejestr konta, a mianowicie AddExport, RetrieveExport, ExportStatus i RemoveExport.
•
Dostęp do interfejsu API WebSocket jest wymagany do pobrania tokenu uwierzytelniania dla interfejsów API WebSocket za pośrednictwem punktu końcowego GetWebSocketsToken.

Jako przykład prawidłowego użycia uprawnień klucza API, rozważ klucz API, który jest udostępniany stronie trzeciej w celach handlowych. Taki klucz API z pewnością wymagałby uprawnień Modyfikuj zlecenia i Anuluj/zamknij zlecenia, prawdopodobnie wymagałby uprawnienia Zapytanie o otwarte zlecenia i transakcje, ale prawie na pewno nie wymagałby uprawnienia Wypłata środków.

Odpowiednie skonfigurowanie uprawnień pozwoliłoby klientowi API na dokonywanie transakcji na koncie, ale uniemożliwiłoby klientowi API dostęp do jakichkolwiek informacji o koncie lub wykonywanie zadań związanych z finansowaniem.

Ustawienia opcjonalne

Pozostałe ustawienia klucza API są wymagane tylko do bardziej zaawansowanych konfiguracji, w związku z tym mogą być zazwyczaj pozostawione w wartościach domyślnych:

•
Okno nonce to ustawienie używane do radzenia sobie z problemami z siecią, które mogą powodować, że żądania API docierają poza kolejnością, poprzez zapewnienie krótkich ram czasowych (1 sekunda, 10 sekund itp.), podczas których żądania API z nieprawidłowym nonce (wartość nonce niższa niż poprzednio używana wartość nonce) nie spowodują błędu nieprawidłowego nonce.
•
Biała lista adresów IP to funkcja bezpieczeństwa, która ogranicza użycie klucza API do określonych adresów IP po stronie klienta.
•
Wygaśnięcie klucza można użyć do utworzenia klucza API, który działa tylko przez określony czas, na przykład klucz ważny tylko przez 1 tydzień.
•
Zapytanie Data/godzina rozpoczęcia/zakończenia to ustawienie, które ogranicza żądania danych historycznych konta do określonych ram czasowych, tak jak klucz, który może pobierać historię transakcji z tego roku, ale nie z poprzednich lat.

Po odpowiednim skonfigurowaniu ustawień klucza API, nowy klucz API można utworzyć, klikając przycisk Wygeneruj klucz.

WAŻNE: Klucz API, klucz prywatny i kod QR należy traktować tak samo jak swoją nazwę użytkownika i hasło. Zapisz je w menedżerze haseł, jeśli będzie konieczny dostęp do nich w późniejszym terminie. Nie zapisuj ich w niezaszyfrowanym formacie!

Używanie klucza API

Klucze API składają się z pary kluczy; publicznego i prywatnego. Oba muszą być dostarczone do oprogramowania klienckiego API.

Klucze API mogą być dostarczane na różne sposoby, na przykład:

•
Parę kluczy można skopiować i wkleić jako zwykły tekst bezpośrednio do kodu klienta API. Przykład: Metoda używana przez naszego klienta PHP API.
•
Parę kluczy można skopiować i wkleić do zwykłych plików tekstowych, do których klient API może mieć dostęp. Przykład: Metoda używana przez naszego klienta API wiersza poleceń.

Uwaga: Klucz prywatny jest również znany przez niektóre oprogramowanie klienckie API, jako sekretne API (lub po prostu jako sekret).

2FA dla klucza API

Klucze API zapewniają bezpieczny sposób na uwierzytelnienie dostępu API do konta Kraken, ale ich bezpieczeństwo można jeszcze zwiększyć, dodając uwierzytelnianie dwuskładnikowe (2FA).

2FA klucza API można dodać do istniejącego klucza API za pośrednictwem strony Bezpieczeństwo i może on używać hasła statycznego lub aplikacji Google Authenticator.

Uwaga: Dodanie 2FA do klucza API wymaga również od klienta API obsługiwania 2FA (dostarczania danych 2FA dla każdego wywołania prywatnych metod API), w przeciwnym razie zamiast pożądanego wyniku API zostanie zwrócony nieoczekiwany błąd.

Przeczytaj więcej o tym, jak działa 2FA dla kluczy API tutaj.