Jak utworzyć klucz API na Kraken Pro

Ostatnia aktualizacja: 31 mar 2025

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

Klucze API są wymagane do wywoływania wszystkich punktów końcowych API specyficznych dla konta (czyli prywatnych), a mianowicie punktów końcowych do zarządzania kontem, handlu, finansowania i zarabiania. Klucze API nie są wymagane do wywoływania punktów końcowych API danych rynkowych (czyli publicznych), 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 nasi klienci wiersza poleceń REST API, niektóre aplikacje mobilne, boty handlowe stron trzecich i wiele innych produktów/usług.

Tworzenie klucza API

•
Zaloguj się do swojego konta Kraken na Kraken Pro
•
Otwórz menu konta (kliknij ikonę ludzika w prawym górnym rogu strony)
•
Wybierz opcję Ustawienia

•
Przejdź do zakładki API, a następnie kliknij "Utwórz klucz API" (będziesz mógł skonfigurować swój klucz API w kolejnych krokach)

Konfigurowanie klucza API

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

Nazwa klucza

Nazwa klucza to zasadniczo nazwa klucza API i może być prawie dowolna, o ile opis jest unikalny (różny od opisów innych kluczy API na tym samym koncie).

Najlepszą praktyką jest nadawanie kluczowi API opisowej nazwy, bez ujawniania wrażliwych informacji. (takich jak "Klucz handlowy", "Klucz 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) klucz API może wywoływać:

Środki

•
Zapytanie o środki jest wymagane dla punktów końcowych API, które odpytują informacje o saldzie konta, takie jak Saldo i Saldo handlowe.
•
Wpłata środków jest wymagana dla punktów końcowych finansowania związanych z wpłatami, takich jak Metody wpłat i Adresy wpłat.
•
Wypłata środków jest wymagana dla punktów końcowych finansowania związanych z wypłatami, takich jak Informacje o wypłacie, Wypłata i Anulowanie wypłaty.

Zlecenia & Transakcje

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

Dane

•
Zapytanie o wpisy do księgi jest wymagane dla punktów końcowych API, które pobierają historyczne dane konta z księgi rachunkowej, a mianowicie Ledgers i QueryLedgers.
•
Eksportuj dane jest wymagane dla punktów końcowych, które eksportują (pobierają) księgę rachunkową, a mianowicie AddExport, RetrieveExport, ExportStatus i RemoveExport.

Jako przykład prawidłowego użycia uprawnień klucza API, rozważ klucz API, który jest udostępniany stronie trzeciej do celów 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łać środki.

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 dla bardziej zaawansowanych konfiguracji, dlatego zazwyczaj można je pozostawić w wartościach domyślnych:

•
Interfejs WebSocket jest wymagany do pobrania tokena uwierzytelniającego dla interfejsów API WebSocket za pośrednictwem punktu końcowego GetWebSocketsToken.
•
Ograniczenie adresu 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że być użyte do utworzenia klucza API, który działa tylko przez określony czas, na przykład klucza ważnego tylko przez 1 tydzień.
•
Zapytanie o datę/godzinę rozpoczęcia/zakończenia to ustawienie, które ogranicza żądania historycznych danych konta do określonego przedziału czasowego, na przykład klucza, który mógłby pobrać historię handlu z bieżącego roku, ale nie z poprzednich lat.
•
Niestandardowe okno Nonce to ustawienie używane do przezwyciężenia problemów z siecią, które mogą powodować, że żądania API docierają w niewłaściwej kolejności, poprzez zapewnienie krótkiego przedziału czasowego (1 sekunda, 10 sekund itp.), podczas którego żądania API z nieprawidłowym nonce (wartość nonce niższa niż wcześniej użyta wartość nonce) nie spowodują błędu nieprawidłowego nonce.

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

Klucz API, klucz prywatny i kod QR powinny być traktowane tak samo jak nazwa użytkownika/hasło. Zapisz je w menedżerze haseł, jeśli będziesz potrzebować do nich dostępu później. Nie zapisuj ich w niezaszyfrowanym formacie!

Używanie klucza API

Klucze API składają się z pary kluczy publicznego i prywatnego, z których oba muszą być dostarczone oprogramowaniu klienta 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 API PHP.
•
Parę kluczy można skopiować i wkleić do plików tekstowych, do których klient API ma dostęp. Przykład: Metoda używana przez naszego klienta API wiersza poleceń.

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

2FA dla klucza API

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

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

Uwaga: Dodanie 2FA do klucza API wymaga również, aby klient API obsługiwał 2FA (dostarczał dane 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.