Referencja błędów

Ta strona zawiera listę błędów zwracanych przez Cryptohopper Market Data MCP i opisuje przyczynę oraz zalecane postępowanie dla każdego z nich.

Aby zapoznać się z przewodnikiem rozwiązywania problemów zorientowanym na zadania, zobacz rozwiązywanie typowych błędów MCP.

Format błędu

Błędy są zwracane do klienta MCP w standardowej kopercie błędów MCP. Pola:

Pole	Typ	Opis
code	string	Stabilny identyfikator pisany wielkimi literami (np. QUOTA_EXCEEDED).
message	string	Opis czytelny dla człowieka.
details	object	Opcjonalny ustrukturyzowany kontekst.

Pole code stanowi stabilny kontrakt. Klienci powinni rozgałęziać się na podstawie code, a nie tekstu message.

Błędy uwierzytelniania

UNAUTHORIZED

Klucz API brakuje, jest zniekształcony, wygasł lub został unieważniony.

Typowe przyczyny:

• Brak nagłówka Authorization w żądaniu.
• Zniekształcony token bearer (białe znaki, artefakty kopiowania-wklejania).
• Klucz został unieważniony w interfejsie konta Cryptohopper.
• Klucz został wygenerowany dla innego produktu i nie jest ważny dla MCP.

Postępowanie: wygeneruj ponownie klucz z interfejsu konta Cryptohopper i przekonfiguruj klienta. Zobacz najlepsze praktyki bezpieczeństwa klucza API i jak uzyskać klucz API Cryptohopper MCP.

FORBIDDEN

Żądanie jest uwierzytelnione, ale konto nie ma uprawnień do wykonania żądanej akcji.

Typowe przyczyny:

• Konto jest zawieszone lub oznaczone.
• Punkt końcowy został ograniczony dla konta.

Postępowanie: skontaktuj się z pomocą techniczną Cryptohopper. Ponowne wygenerowanie klucza nie rozwiąże tego błędu.

Błędy kwot i limitów szybkości

QUOTA_EXCEEDED

Konto osiągnęło swój tygodniowy limit wywołań.

Postępowanie: poczekaj na następny reset (piątek), zmień poziom subskrypcji lub przeanalizuj wzorce wywołań, aby zmniejszyć użycie. Pole details.reset_at zawiera znacznik czasu następnego resetu.

Zobacz wyjaśnienie limitów szybkości i poziomy subskrypcji.

RATE_LIMIT_EXCEEDED

Konto przekroczyło limit szybkości krótkiego interwału.

Postępowanie: ponów próbę po krótkim opóźnieniu. Dobrze zachowujący się klienci wycofują się wykładniczo; początkowe ponowienie próby po 500ms jest zazwyczaj wystarczające. Jeśli błąd się powtarza, dodaj małe opóźnienie między sekwencyjnymi wywołaniami w swoim przepływie pracy.

HISTORY_LIMIT_EXCEEDED

Żądanie świecy określiło wsteczny okres większy niż maksymalna historia aktywnego poziomu.

Postępowanie: zmniejsz wsteczny okres lub zmień poziom na taki z głębszą historią. Zobacz poziomy subskrypcji.

Błędy poziomu i dostępu

EXCHANGE_NOT_SUPPORTED

Żądana giełda nie jest dostępna dla aktywnego poziomu lub nie jest w ogóle obsługiwana przez MCP.

Postępowanie: potwierdź, że giełda znajduje się na liście dozwolonych poziomu w obsługiwanych giełdach. Jeśli giełda jest wymieniona dla wyższego poziomu, zmień poziom. Jeśli nie jest w ogóle wymieniona, giełda nie jest obsługiwana.

PAIR_NOT_FOUND

Żądana para nie istnieje na określonej giełdzie lub symbol pary jest zniekształcony.

Postępowanie: zweryfikuj symbol pary używając narzędzia list-pairs. Symbole par używają formatu BASE/QUOTE (np. BTC/USDT).

TIMEFRAME_NOT_SUPPORTED

Żądany przedział czasowy świecy (interwał) nie jest obsługiwany dla tej giełdy lub pary.

Postępowanie: użyj obsługiwanego przedziału czasowego. Zobacz dokumentację narzędzia candle.

Błędy żądań

INVALID_PARAMETER

Jeden lub więcej argumentów narzędzia nie przeszło walidacji.

Typowe przyczyny:

• Wsteczny okres mniejszy niż 1 lub powyżej maksimum poziomu.
• Wartości nie będące ciągami znaków tam, gdzie wymagane są ciągi.
• Zniekształcone identyfikatory giełd lub par.

Postępowanie: obiekt details zawiera wadliwy parametr. Popraw i ponów próbę.

MISSING_PARAMETER

Wymagany argument nie został podany.

Postępowanie: obiekt details wskazuje brakujący parametr. Popraw i ponów próbę.

Błędy upstream

EXCHANGE_UNAVAILABLE

Podstawowe API giełdy nie odpowiada lub zwraca błędy. To jest zazwyczaj przejściowe.

Postępowanie: ponów próbę po krótkim opóźnieniu. Jeśli błąd utrzymuje się na wielu giełdach, może to wskazywać na incydent po stronie MCP — sprawdź stronę statusu Cryptohopper.

DATA_UNAVAILABLE

Żądane dane istnieją koncepcyjnie, ale są tymczasowo niedostępne (na przykład seria świec, która nie została jeszcze wypełniona).

Postępowanie: ponów próbę po opóźnieniu. W przypadku długotrwałych awarii wybierz inną giełdę lub inną parę.

Błędy serwera

INTERNAL_ERROR

Wystąpił nieoczekiwany błąd wewnątrz serwera MCP.

Postępowanie: ponów próbę raz. Jeśli błąd się utrzymuje, zgłoś go przez pomoc techniczną Cryptohopper z details.trace_id, jeśli jest obecny.

SERVICE_UNAVAILABLE

Usługa MCP jest tymczasowo niezdolna do obsługi żądań. Zwykle podczas konserwacji lub przy nietypowym obciążeniu.

Postępowanie: ponów próbę po opóźnieniu. Sprawdź stronę statusu Cryptohopper w poszukiwaniu bieżących incydentów.

Tabela szybkiego odniesienia

Kod	Kategoria	Ponowić?	Rozwiązanie
UNAUTHORIZED	Uwierzytelnianie	Nie	Wygeneruj ponownie klucz
FORBIDDEN	Uwierzytelnianie	Nie	Skontaktuj się z pomocą techniczną
QUOTA_EXCEEDED	Kwota	Przy resecie	Zmień poziom lub zmniejsz użycie
RATE_LIMIT_EXCEEDED	Kwota	Po opóźnieniu	Ogranicz klienta
HISTORY_LIMIT_EXCEEDED	Poziom	Nie	Zmniejsz wsteczny okres / zmień poziom
EXCHANGE_NOT_SUPPORTED	Poziom	Nie	Sprawdź listę dozwolonych poziomu
PAIR_NOT_FOUND	Żądanie	Nie	Zweryfikuj symbol pary
TIMEFRAME_NOT_SUPPORTED	Żądanie	Nie	Użyj obsługiwanego przedziału czasowego
INVALID_PARAMETER	Żądanie	Nie	Popraw parametr
MISSING_PARAMETER	Żądanie	Nie	Dodaj parametr
EXCHANGE_UNAVAILABLE	Upstream	Tak	Krótkie ponowienie
DATA_UNAVAILABLE	Upstream	Tak	Opóźnienie, następnie ponów
INTERNAL_ERROR	Serwer	Raz	Zgłoś jeśli utrzymuje się
SERVICE_UNAVAILABLE	Serwer	Tak	Opóźnienie, następnie ponów