Abonnementstufen
Diese Seite dokumentiert die Abonnementstufen, die für die Cryptohopper Market Data MCP verfügbar sind.
Stufenübersicht
| Pioneer | Explorer | Adventurer | Hero | |
|---|---|---|---|---|
| Kosten | Kostenlos | Bezahlt | Bezahlt | Bezahlt |
| Wöchentliches Anruf-Limit | 6.000 | 30.000 | 150.000 | 1.250.000 |
| Börsen | 3 | 8 | Alle unterstützten | Alle unterstützten |
| Historische Daten | Keine | Bis zu 90 Tage | Bis zu 365 Tage | Bis zu 3 Jahre |
| Kostenfaktor historische Daten | — | 5× / 20× | 5× / 20× | 1× (pauschal) |
| Erlaubte API-Schlüssel | 1 | 1 | 3 | 10 |
Alle Limits werden jeden Freitag zurückgesetzt. Das wöchentliche Anruf-Limit und das Raten-Limit gelten pro Benutzerkonto, nicht pro API-Schlüssel.
Für die aktuelle Preisgestaltung der bezahlten Stufen siehe die Cryptohopper Preisseite.
Wöchentliches Anruf-Limit
Jede Stufe hat eine feste Anzahl von Anrufen, die pro Kalenderwoche getätigt werden können. Anrufe werden pro Tool-Aufruf gezählt. Ein einzelner Tool-Aufruf zählt als Basis-Einheit, unterliegt jedoch dem unten beschriebenen historischen Kostenfaktor.
Der wöchentliche Zähler wird jeden Freitag zurückgesetzt. Die genaue Zurücksetzungszeit wird im Benutzerkonto aufgezeichnet und ist über den Usage-Endpunkt sichtbar. Siehe Nutzung und Limits.
Anfragen, die nach Erreichen des wöchentlichen Limits gestellt werden, geben einen QUOTA_EXCEEDED-Fehler zurück, bis zum nächsten Reset. Siehe Fehler-Referenz.
Börsen-Zugriff
Der Börsen-Zugriff ist stufenabhängig. Die Pioneer-Stufe ist auf drei Börsen beschränkt; Explorer erweitert dies auf acht; Adventurer und Hero bieten Zugriff auf die vollständige Liste.
Siehe unterstützte Börsen für die vollständige Matrix.
Anfragen, die auf eine Börse außerhalb der Zulassungsliste der aktuellen Stufe abzielen, geben einen EXCHANGE_NOT_SUPPORTED-Fehler zurück.
Historische Daten
Historische Daten beziehen sich auf Candle-Abfragen mit einem Rückblickzeitraum, der über die aktuellste Bar hinausgeht.
| Stufe | Verfügbarkeit historischer Daten |
|---|---|
| Pioneer | Nicht verfügbar. Nur die aktuelle (Echtzeit-)Candle wird zurückgegeben. |
| Explorer | Bis zu 90 Tage Historie. |
| Adventurer | Bis zu 365 Tage Historie. |
| Hero | Bis zu 3 Jahre Historie. |
Anfragen, die das historische Limit der aktuellen Stufe überschreiten, geben einen HISTORY_LIMIT_EXCEEDED-Fehler zurück.
Ticker- und Orderbuch-Abfragen erfolgen immer in Echtzeit und unterliegen nicht dem historischen Limit.
Kostenfaktor für historische Daten
Bei den Stufen Explorer und Adventurer werden historische Candle-Abfragen mit einem Multiplikator im Verhältnis zur Basis-Einheit pro Anruf berechnet:
| Rückblicktiefe | Kosten-Multiplikator |
|---|---|
| Kurze Historie (kürzlich) | 5× |
| Lange Historie (nahe am Stufen-Limit) | 20× |
Bei der Hero-Stufe werden alle historischen Abfragen mit 1× berechnet, unabhängig von der Rückblicktiefe.
Ticker- und Orderbuch-Abfragen werden bei allen Stufen immer mit 1× berechnet.
Die genauer Schwellenwerte zwischen „kurzer" und „langer" Historie sowie die vollständige Kostenmatrix sind in Raten-Limits erklärt dokumentiert.
API-Schlüssel
Jede Stufe erlaubt eine maximale Anzahl gleichzeitig aktiver API-Schlüssel:
| Stufe | Max. Schlüssel |
|---|---|
| Pioneer | 1 |
| Explorer | 1 |
| Adventurer | 3 |
| Hero | 10 |
API-Schlüssel werden über die Cryptohopper-Kontooberfläche generiert und widerrufen.
Kontobezogenes Kontingent. Das Erstellen zusätzlicher Schlüssel erhöht nicht das wöchentliche Anruf-Limit. Alle Schlüssel, die mit einem Konto verknüpft sind, teilen sich dasselbe wöchentliche Kontingent und Raten-Limit. Schlüssel werden zur Segmentierung und Rotation verwendet, nicht zur Kontingent-Vervielfachung. Siehe wie du mehrere Agenten mit mehreren API-Schlüsseln ausführst.
Siehe Best Practices für API-Schlüssel-Sicherheit.
Raten-Limits
Raten-Limits gelten auf Kontoebene und sind stufenübergreifend einheitlich. Details sind in Raten-Limits erklärt dokumentiert.
Upgrade und Downgrade
Stufenwechsel treten zu Beginn des nächsten wöchentlichen Zyklus in Kraft. Ein Downgrade auf eine Stufe mit geringerem API-Schlüssel-Kontingent kann das Widerrufen von Schlüsseln erfordern, um innerhalb des neuen Kontingents zu bleiben.
Überprüfung der aktiven Stufe
Die aktuelle Stufe wird vom Usage-Endpunkt als tier-Feld zurückgegeben. Siehe Nutzung und Limits.
Beispielabfrage über einen MCP-Client:
Was ist meine aktuelle Cryptohopper MCP-Stufe und wie viel meines wöchentlichen Kontingents habe ich verbraucht?