Konto, klucze i przegląd użytkowania

Ta strona opisuje, jak konto Cryptohopper, jego klucze API i użytkowanie MCP są ze sobą powiązane. Jest to mapa koncepcyjna, która łączy poziomy subskrypcji, bezpieczeństwo kluczy API i limity.

Model konta

Konto Cryptohopper jest głównym źródłem autoryzacji dla wszystkiego, co opisane jest w tych dokumentach. Konto przechowuje:

• Aktywny poziom subskrypcji (Pioneer, Explorer, Adventurer, Hero).
• Zestaw kluczy API (z limitami według poziomu określającymi, ile może istnieć jednocześnie).
• Aktualny licznik tygodniowego użytkowania i czas resetowania.
• Listę giełd, do których konto ma uprawnienia do zapytań.

Wszystkie żądania MCP uwierzytelniają się za pomocą klucza API, który z kolei jest przypisany do konta. Wszystkie limity opisane w tych dokumentach są egzekwowane per konto.

Klucze API

Klucz API to token wydany przez konto. Jest przedstawiany w nagłówku Authorization każdego żądania MCP:

Authorization: Bearer 

Właściwości klucza

Właściwość	Opis
Własność	Klucze są powiązane z kontem, które je utworzyło.
Zakres	Wszystkie klucze w ramach konta mają identyczny dostęp — ten sam poziom, te same giełdy, ten sam limit.
Unieważnienie	Klucze mogą być unieważnione w dowolnym momencie przez interfejs konta Cryptohopper. Unieważnienie działa natychmiast.
Rotacja	Nowy klucz może być utworzony, a stary unieważniony niezależnie.
Limit	Klucze współdzielą pojedynczy tygodniowy limit konta. Utworzenie dodatkowych kluczy nie zwiększa limitu.

Kiedy używać wielu kluczy

Liczba kluczy, które konto może przechowywać, zależy od poziomu (zobacz poziomy subskrypcji). Wiele kluczy jest przydatnych do:

• Rozdzielenia według agenta. Różni agenci AI lub przepływy pracy otrzymują własny klucz. Podczas rotacji lub unieważniania klucza, dotknięty jest tylko właściciel agenta.
• Rozdzielenia według środowiska. Klucz produkcyjny i klucz deweloperski, każdy możliwy do niezależnego unieważnienia.
• Przypisania. Logi użytkowania (gdzie dostępne) mogą być sprawdzane per klucz, aby zidentyfikować, który konsument zużywa limit.

Wiele kluczy nie wpływa na limit. Wszystkie klucze współdzielą ten sam tygodniowy limit na poziomie konta. Zobacz jak uruchomić wielu agentów z wieloma kluczami API.

Użytkowanie

Użytkowanie jest śledzone per konto w jednostkach wywołań. Licznik tygodniowy zwiększa się za każdym razem, gdy wywoływane jest narzędzie. Zobacz wyjaśnienie limitów, aby dowiedzieć się, jak wywołania przekładają się na jednostki.

MCP udostępnia narzędzie inspekcji, które zwraca aktualny stan użytkowania:

Pole	Typ	Opis
tier	string	Aktywny poziom subskrypcji.
calls_used	integer	Jednostki zużyte w bieżącym cyklu tygodniowym.
calls_limit	integer	Tygodniowy limit poziomu.
reset_at	string (ISO-8601)	Znacznik czasu następnego tygodniowego resetowania.

Zobacz użytkowanie i limity, aby uzyskać pełny schemat odpowiedzi i przykładowe wywołania.

Tygodniowe resetowanie

Wszystkie konta mają tę samą kadencję resetowania: licznik tygodniowy resetuje się w każdy piątek. Dokładny czas resetowania per konto jest stabilny w kolejnych tygodniach i jest zwracany w polu reset_at.

Błędy związane z użytkowaniem (QUOTA_EXCEEDED) są automatycznie usuwane podczas resetowania.

Poziom i pokrycie giełd

Poziom konta określa:

• Które giełdy mogą być odpytywane przez MCP.
• Ile historycznych danych świecowych może być żądanych.
• Ile kluczy API może istnieć jednocześnie.
• Tygodniowy limit wywołań i współczynnik kosztów dla danych historycznych.

Zobacz poziomy subskrypcji, aby uzyskać pełną matrycę i obsługiwane giełdy dla listy giełd.

Niepowodzenie uwierzytelniania

Nieprawidłowy, unieważniony lub źle sformatowany klucz API zwraca odpowiedź 401 Unauthorized, zmapowaną na błąd UNAUTHORIZED w schemacie błędów MCP. Zobacz referencję błędów.

Kwestie bezpieczeństwa

Klucze API dają dostęp do odczytu danych rynkowych w ramach poziomu konta. Nie dają dostępu do botów Cryptohopper, danych uwierzytelniających API giełdy ani samego konta. Mimo to skompromitowane klucze zużywają limit i mogą przyczyniać się do zakłóceń związanych z limitami.

Zobacz najlepsze praktyki bezpieczeństwa kluczy API, aby uzyskać wskazówki dotyczące:

• Przechowywania i zarządzania sekretami.
• Kadencji rotacji kluczy.
• Unieważniania skompromitowanych kluczy.
• Rozdzielania kluczy według środowiska.

Związek z Cryptohopper Trading API

Cryptohopper MCP i Cryptohopper REST Trading API używają oddzielnych tokenów uwierzytelniania wydanych w ramach tego samego konta. Klucz MCP nie autoryzuje wywołań Trading API i odwrotnie.

Dla agentów end-to-end, które używają MCP do badań i Trading API do wykonywania, wymagane są oba dane uwierzytelniające. Zobacz Połącz MCP + Cryptohopper Trading API dla agentów end-to-end.

Sprawdzanie stanu konta z klienta MCP Typowe zapytania wydawane z klienta kompatybilnego z MCP:

Jaki jest mój aktualny poziom Cryptohopper MCP? Ile z mojego tygodniowego limitu zużyłem? Które giełdy mogę odpytywać?

Każde z nich prowadzi do odpowiedniego narzędzia i zwraca ustrukturyzowaną odpowiedź, którą model podsumowuje.