Komunikaty o błędach API

Błędy odmowy dostępu są zwracane, gdy klient API próbuje wykonać zadanie, do którego klucz API nie ma uprawnień. Na przykład, jeśli klient API próbował pobrać saldo konta za pomocą klucza API skonfigurowanego tak, aby zezwalał na dostęp do handlu, ale nie do zarządzania kontem, wówczas zwrócony zostałby błąd odmowy dostępu. Możesz przejrzeć swoje klucze API i ich ustawienia (takie jak uprawnienia) za pośrednictwem zakładki Ustawienia -> API w zarządzaniu kontem. Musisz upewnić się, że klucze API używane przez Twoje aplikacje stron trzecich mają wszystkie ustawienia i uprawnienia, których wymagają Twoje aplikacje.

Ten błąd jest zwracany, gdy klucz API użyty do wywołania jest wygasły lub wyłączony. Prosimy o sprawdzenie klucza API w zakładce Ustawienia -> API w zarządzaniu kontem lub wygenerowanie nowego i zaktualizowanie aplikacji.

Możesz pobrać pełną listę naszych par aktywów z publicznego wywołania AssetPairs i wyszukać nazwę pary jako wpis w nagłówkach Json lub za pomocą parametru „altname”: https://api.kraken.com/0/public/AssetPairs

Ten błąd jest zwracany, gdy metoda jest wywoływana bez wymaganych parametrów. Na przykład, wywołanie metody QueryOrders bez podania prawidłowego identyfikatora transakcji (txid) spowodowałoby zwrócenie błędu nieprawidłowych argumentów. Wywołanie metody z niepotrzebnymi parametrami nadal nie zwróciłoby błędu nieprawidłowych argumentów, ponieważ niepotrzebne parametry zostałyby po prostu zignorowane.

Błędy nieprawidłowego podpisu występują, jeśli klucz API lub tajny klucz API są niepoprawnie zapisane w programie lub jeśli dane POST użyte do uwierzytelnienia i dane POST wysłane do API nie pasują.W celach informacyjnych, poniżej znajduje się przykładowy kod Python do implementacji algorytmu podpisu API. Odpowiedni publiczny klucz API powinien zostać skopiowany i wklejony z zarządzania kontem, a metoda API i dane POST powinny zostać odpowiednio zaktualizowane. Wartość wyjściowa może być użyta bezpośrednio jako wartość nagłówka HTTP API-Sign. #!/usr/bin/env python

# Importuj wymagane biblioteki Python
import time
import base64
import hashlib
import hmac

# Dekoduj prywatny klucz API z formatu base64 wyświetlanego w zarządzaniu kontem
api_secret = base64.b64decode("nmlrD83t1J+yVWKUBx9vD6j26C5zhC11tFfXpN+Ww+8oOVuGgse5AeADcvl95jYaD+UAi3D5CrVfFr8GfQ7zhA==")

# Zmienne (metoda API, nonce i dane POST)
api_path = "/0/private/TradeBalance"
api_nonce = str(int(time.time()*1000))
api_post = "nonce=" + api_nonce + "&asset=xxbt"

# Algorytmy haszujące kryptograficzne
api_sha256 = hashlib.sha256(api_nonce + api_post).digest()
api_hmac = hmac.new(api_secret, api_path + api_sha256, hashlib.sha512)

# Zakoduj podpis do formatu base64 używanego w wartości API-Sign
api_signature = base64.b64encode(api_hmac.digest())

# Podpis uwierzytelniania API do użycia w nagłówku HTTP API-Sign
print(api_signature)SHA256 jest obliczany przy użyciu wartości nonce i danych POST dla metody API, a DANE POST składają się z par nazwa/wartość dla nonce (ponownie) i parametrów metody API. Przykład danych, które powinny zostać przekazane do SHA256 dla metody TradeBalance, wyglądałby następująco:SHA256 = SHA256 z "1541933977000nonce=1541933977000&asset=xxbt"Wartość ciągu znaków przekazywana do SHA256 nie powinna zawierać żadnych dodatkowych wartości null (\0) i nie powinna być kodowana jako base64 ani hex (tj. wartość ciągu znaków powinna być zwykłym tekstem).Ścieżka URI to cały adres URL metody API z wyjątkiem prefiksu "https://api.kraken.com", więc ścieżka URI metody TradeBalance (na przykład) byłaby wartością ciągu znaków "/0/private/TradeBalance" bez żadnych dodatkowych wartości null.HMAC SHA512 jest obliczany przy użyciu ścieżki URI i wcześniej obliczonego skrótu SHA256, z prywatnym kluczem API dekodowanym z base64 jako kluczem HMAC. Przykład danych, które powinny zostać przekazane do HMAC, wyglądałby następująco:HMAC SHA512 używając prywatnego klucza dekodowanego z base64 = HMAC z "/0/private/TradeBalanceSHA256"Nagłówki HTTP API-Key i API-Sign to jedyne dwa wymagane niestandardowe nagłówki HTTP. Nagłówek API-Key jest dokładną kopią publicznego klucza API z zarządzania kontem. Nagłówek API-Sign to skrót HMAC SHA512 zakodowany przy użyciu base64.

Więcej informacji na temat tego błędu znajdziesz tutaj:https://support.kraken.com/hc/en-us/articles/360001148063A więcej o Nonce i Nonce Window tutaj:https://support.kraken.com/hc/en-us/articles/360000906023https://support.kraken.com/hc/en-us/articles/360001148023

Błędy nieprawidłowej sesji są zwracane za pośrednictwem interfejsu API WebSocket, gdy podejmowana jest próba subskrypcji uwierzytelnionego (prywatnego) kanału przy użyciu tokena uwierzytelniającego, który nie jest już ważny (np. wygasł).

Rozwiązaniem jest po prostu zażądanie nowego tokena uwierzytelniającego za pośrednictwem punktu końcowego REST API GetWebSocketsToken i użycie nowego tokena do wszystkich kolejnych uwierzytelnionych (prywatnych) żądań subskrypcji.

Błąd złego żądania wskazuje, że coś jest niepoprawne w podstawowym żądaniu HTTP (nie w kolejnym żądaniu API), takie jak niezgodne adresy URL między REST/WebSocket, lub nieprawidłowe uwzględnienie danych HTTP POST:

% curl --data "" https://api.kraken.com/0/private/GetWebSocketsToken

{"error":["EAPI:Bad request"]}

Ten błąd jest zwracany, gdy wywoływany punkt końcowy nie jest prawidłowym punktem końcowym.

Przekroczyłeś limit szybkości API.

Chociaż dodawanie i anulowanie zleceń nie wlicza się do naszych standardowych limitów liczników API, te operacje mają własny licznik dodawania i anulowania zleceń. Ten licznik działa w taki sposób, że im dłużej zlecenia pozostają w arkuszu zleceń, tym więcej zleceń klienci mogą dodać lub anulować.

Komunikaty o błędach tymczasowej blokady mogą wystąpić, jeśli miałeś zbyt wiele nieudanych wywołań API lub zbyt wiele błędów nieprawidłowego nonce w krótkim czasie, lub nieprawidłowe podpisy. Nawet jeśli te wywołania zwracają błąd, ten błąd nadal wlicza się do Twoich limitów API i może skutkować tymczasową blokadą.

Tymczasowe blokady trwają około 15 minut. Po otrzymaniu błędu tymczasowej blokady, poczekaj 15 minut przed wysłaniem jakichkolwiek nowych żądań API. Jeśli wywołujesz kilka błędów nieprawidłowego nonce, zwiększ okno nonce, ponieważ może to pomóc zmniejszyć częstotliwość występowania tych błędów. Spróbuj również zmniejszyć częstotliwość swoich prywatnych wywołań API.

Otwieranie nowych pozycji spot z depozytem zabezpieczającym zostało tymczasowo zawieszone z powodu konserwacji silnika handlowego. Funkcja zostanie wkrótce przywrócona, a aktualizacje można śledzić na status.kraken.com.

Innym powodem może być to, że pozycje spot z depozytem zabezpieczającym nie są obecnie dostępne dla klientów zamieszkujących w niektórych krajach.

Na Krakenie nie można otwierać długiej i krótkiej pozycji dla tej samej pary.

Jeśli chcesz otworzyć długą i krótką pozycję dla tej samej waluty, wybierz różne pary handlowe z tą samą walutą jako walutą bazową lub kwotowaną. Np.: krótka XBT/USD, długa XBT/EUR.

Ten błąd występuje, gdy przekroczyłeś limity dopuszczalnego marginesu dla Twojego obecnego poziomu weryfikacji. Limity dopuszczalnego marginesu dla każdej waluty różnią się w zależności od Twojego obecnego poziomu weryfikacji.

Mamy ograniczone środki dostępne na rozszerzenia marginesu. Komunikat "niewystarczający margines" wskazuje, że chwilowo wyczerpały się środki w odpowiedniej puli marginesu. Może się to zmienić w każdej chwili. Możesz być w stanie pomyślnie złożyć zamówienie zaledwie kilka sekund lub minut później, ale zamówienia o dużej objętości i zamówienia składane w godzinach szczytu mogą trwać dłużej. Przepraszamy za wszelkie niedogodności.

Ten błąd występuje, gdy na koncie brakuje wolnego marginesu do otwarcia nowej pozycji lub gdy obecna próba otwarcia pozycji spowodowałaby spadek wolnego marginesu konta poniżej 100%.

Nie masz wystarczających środków, aby złożyć to zamówienie. Sprawdź swoje otwarte pozycje i zamówienia pod kątem pozycji, które mogą blokować Twoje środki.

Nie osiągnąłeś minimalnej wielkości zamówienia dla tego aktywa.

Przekroczyłeś maksymalną liczbę otwartych zamówień dostępnych dla Twojego konta.

Limity te są oparte na Twoim poziomie weryfikacji. Zamknij niektóre ze swoich otwartych zamówień lub zweryfikuj swoje konto na wyższym poziomie.

Przekroczyłeś maksymalną liczbę otwartych pozycji dostępnych dla Twojego konta.

Limity te są oparte na Twoim poziomie weryfikacji. Zamknij lub rozlicz niektóre lub wszystkie swoje otwarte pozycje lub zweryfikuj swoje konto na wyższym poziomie, jeśli to możliwe.

Podjęto próbę edycji istniejącego (otwartego) zamówienia, ale modyfikacje nie mogły zostać pomyślnie zakończone. Możliwe przyczyny to niewystarczające środki na nowe zamówienie, niektóre scenariusze częściowego wypełnienia oraz niektóre zamówienia lewarowane.

Nowa wielkość jest mniejsza niż już zrealizowana/wypełniona wielkość.

Rozmiar zlecenia przekroczył limit rozmiaru pozycji margin dla pary handlowej.

Wyświetlana wielkość nie osiągnęła minimalnej wielkości zlecenia.

Wyświetlana wielkość musi być mniejsza niż wielkość zlecenia.

Zlecenia typu iceberg nie są kompatybilne z żadnymi innymi typami zleceń poza zleceniem z limitem.

Każda kryptowaluta ma maksymalnie 5 nowych (nieużywanych) adresów depozytowych, po czym każda próba utworzenia 6. nowego adresu zwróci błąd.

Ten błąd jest zwracany za każdym razem, gdy punkty końcowe finansowania są wywoływane z nieprawidłowym lub brakującym parametrem "method". 

Parametr wejściowy "key" nie odpowiada opisowi adresu ustawionemu w zarządzaniu kontem (poprzez Finansowanie -> Wypłata).

Minimalne kwoty wypłat różnią się w zależności od waluty, a każda próba wypłaty poniżej minimum spowodowałaby ten błąd.

Jest to ogólny błąd wskazujący, że żądanie finansowania nie mogło zostać zrealizowane (na przykład, klienci z niektórych lokalizacji próbujący dokonać żądań stakingu on-chain spowodowaliby ten błąd).

Żądana wypłata nie mogła zostać zrealizowana, ponieważ adres docelowy nie zawiera wymaganych informacji o beneficjencie/odbiorcy (należy pamiętać, że dotyczy to obecnie tylko wybranych wypłat z kont kanadyjskich).

Błędy usługi, których doświadczasz, powinny być tylko tymczasowe. Możesz spróbować ponownie przesłać swoje żądania, jeśli się nie powiodły. Będziemy monitorować problemy i aktualizować naszą stronę:

https://status.kraken.com/

Gdy napotykamy problemy z degradacją API, mogą one przekładać się na problemy dla Krakena w postaci komunikatów o niedostępności usługi i awarii witryny.

Ten problem dotyczy bezpieczeństwa Twojego konta, które mogło zostać naruszone. Zmień hasło i uwierzytelnianie dwuskładnikowe, a następnie skontaktuj się z naszym Centrum Wsparcia.

Ten błąd występuje, gdy flaga lub parametr wejściowy jest tymczasowo lub trwale wyłączony. Błąd powinien pochodzić z jednego z przekazanych danych wejściowych. Skontaktuj się z naszym wsparciem, wysyłając dziennik z kompletnymi informacjami używanymi do wywołania, które wygenerowało błąd.

Te błędy 5xx i 10xx nie są w rzeczywistości błędami API, lecz błędami serwera internetowego pochodzącymi z Cloudflare.

Błędy API są zawsze zwracane w formacie JSON, np. „error”:[„ErrorType:ErrorMessage”], więc za każdym razem, gdy otrzymany zostanie błąd w innym formacie (np. kod statusu HTTP 520, 504, 502, 1020 itp.), tymczasowym rozwiązaniem jest ponowne wywołanie API wkrótce potem, a wtedy, miejmy nadzieję, wywołanie zakończy się sukcesem.