Fehler-Referenz

Diese Seite listet die Fehler auf, die vom Cryptohopper Market Data MCP zurückgegeben werden, und beschreibt die Ursache und empfohlene Behandlung für jeden Fehler.

Für eine aufgabenorientierte Anleitung zur Fehlersuche, siehe Fehlerbehebung bei häufigen MCP-Fehlern.

Fehlerformat

Fehler werden dem MCP-Client im Standard-MCP-Fehler-Envelope zurückgegeben. Die Felder:

Feld	Typ	Beschreibung
code	string	Ein stabiler, großgeschriebener Identifikator (z.B. QUOTA_EXCEEDED).
message	string	Eine menschenlesbare Beschreibung.
details	object	Optionaler strukturierter Kontext.

Der code ist der stabile Vertrag. Clients sollten auf code verzweigen, nicht auf den Text von message.

Authentifizierungsfehler

UNAUTHORIZED

Der API-Schlüssel fehlt, ist fehlerhaft, abgelaufen oder widerrufen.

Häufige Ursachen:

• Kein Authorization-Header in der Anfrage.
• Fehlerhaftes Bearer-Token (Leerzeichen, Copy-Paste-Artefakte).
• Schlüssel wurde in der Cryptohopper-Kontooberfläche widerrufen.
• Schlüssel wurde für ein anderes Produkt generiert und ist für das MCP nicht gültig.

Behandlung: Generiere den Schlüssel aus der Cryptohopper-Kontooberfläche neu und konfiguriere den Client neu. Siehe Best Practices für API-Schlüsselsicherheit und wie du einen Cryptohopper MCP API-Schlüssel erhältst.

FORBIDDEN

Die Anfrage ist authentifiziert, aber das Konto hat keine Berechtigung, die angeforderte Aktion auszuführen.

Häufige Ursachen:

• Konto ist gesperrt oder markiert.
• Der Endpoint wurde für das Konto eingeschränkt.

Behandlung: Kontaktiere den Cryptohopper-Support. Das Neugenerieren des Schlüssels wird diesen Fehler nicht beheben.

Kontingent- und Rate-Limit-Fehler

QUOTA_EXCEEDED

Das Konto hat sein wöchentliches Aufruf-Limit erreicht.

Behandlung: Warte auf das nächste Reset (Freitag), upgrade die Abonnementstufe oder überprüfe die Aufrufmuster, um die Nutzung zu reduzieren. Das Feld details.reset_at enthält den Zeitstempel des nächsten Resets.

Siehe Rate Limits erklärt und Abonnementstufen.

RATE_LIMIT_EXCEEDED

Das Konto hat das Kurzintervall-Rate-Limit überschritten.

Behandlung: Versuche es nach einer kurzen Verzögerung erneut. Gut funktionierende Clients verwenden exponentielles Backoff; ein erster Wiederholungsversuch nach 500ms ist typischerweise ausreichend. Wenn der Fehler erneut auftritt, füge eine kleine Verzögerung zwischen aufeinanderfolgenden Aufrufen in deinem Workflow hinzu.

HISTORY_LIMIT_EXCEEDED

Eine Candle-Anfrage hat einen Lookback angegeben, der größer ist als das maximale Verlaufs-Limit der aktiven Stufe.

Behandlung: Reduziere den Lookback oder upgrade auf eine Stufe mit tieferem Verlauf. Siehe Abonnementstufen.

Stufen- und Zugriffsfehler

EXCHANGE_NOT_SUPPORTED

Die angeforderte Börse ist für die aktive Stufe nicht verfügbar oder wird vom MCP überhaupt nicht unterstützt.

Behandlung: Bestätige, dass die Börse in der Zulassungsliste der Stufe in unterstützten Börsen aufgeführt ist. Wenn die Börse für eine höhere Stufe aufgeführt ist, upgrade. Wenn sie überhaupt nicht aufgeführt ist, wird die Börse nicht unterstützt.

PAIR_NOT_FOUND

Das angeforderte Paar existiert nicht auf der angegebenen Börse oder das Paar-Symbol ist fehlerhaft.

Behandlung: Überprüfe das Paar-Symbol mit dem list-pairs-Tool. Paar-Symbole verwenden das BASE/QUOTE-Format (z.B. BTC/USDT).

TIMEFRAME_NOT_SUPPORTED

Der angeforderte Candle-Timeframe (Intervall) wird für diese Börse oder dieses Paar nicht unterstützt.

Behandlung: Verwende einen unterstützten Timeframe. Siehe Candle-Tool-Referenz.

Anfragefehler

INVALID_PARAMETER

Ein oder mehrere Tool-Argumente haben die Validierung nicht bestanden.

Häufige Ursachen:

• Lookback kleiner als 1 oder über dem Stufen-Maximum.
• Nicht-String-Werte, wo Strings erforderlich sind.
• Fehlerhafte Börsen- oder Paar-Identifikatoren.

Behandlung: Das details-Objekt enthält den fehlerhaften Parameter. Korrigiere und versuche es erneut.

MISSING_PARAMETER

Ein erforderliches Argument wurde nicht bereitgestellt.

Behandlung: Das details-Objekt benennt den fehlenden Parameter. Korrigiere und versuche es erneut.

Upstream-Fehler

EXCHANGE_UNAVAILABLE

Die zugrunde liegende Börsen-API reagiert nicht oder gibt Fehler zurück. Dies ist typischerweise vorübergehend.

Behandlung: Versuche es nach einer kurzen Verzögerung erneut. Wenn der Fehler bei mehreren Börsen weiterhin besteht, könnte dies auf einen MCP-seitigen Vorfall hinweisen — überprüfe die Cryptohopper-Status-Seite.

DATA_UNAVAILABLE

Die angeforderten Daten existieren konzeptionell, sind aber vorübergehend nicht verfügbar (zum Beispiel eine Candle-Serie, die noch nicht befüllt wurde).

Behandlung: Versuche es nach einer Verzögerung erneut. Für langanhaltende Ausfälle wähle eine andere Börse oder ein anderes Paar.

Server-Fehler

INTERNAL_ERROR

Ein unerwarteter Fehler ist innerhalb des MCP-Servers aufgetreten.

Behandlung: Versuche es einmal erneut. Wenn der Fehler weiterhin besteht, melde ihn über den Cryptohopper-Support mit der details.trace_id, falls vorhanden.

SERVICE_UNAVAILABLE

Der MCP-Service ist vorübergehend nicht in der Lage, Anfragen zu bearbeiten. Normalerweise während Wartungsarbeiten oder unter ungewöhnlicher Last.

Behandlung: Versuche es nach einer Verzögerung erneut. Überprüfe die Cryptohopper-Status-Seite auf laufende Vorfälle.

Schnellreferenz-Tabelle

Code	Kategorie	Erneut versuchen?	Behebung
UNAUTHORIZED	Auth	Nein	Schlüssel neu generieren
FORBIDDEN	Auth	Nein	Support kontaktieren
QUOTA_EXCEEDED	Kontingent	Beim Reset	Stufe upgraden oder Nutzung reduzieren
RATE_LIMIT_EXCEEDED	Kontingent	Nach Verzögerung	Client drosseln
HISTORY_LIMIT_EXCEEDED	Stufe	Nein	Lookback reduzieren / Stufe upgraden
EXCHANGE_NOT_SUPPORTED	Stufe	Nein	Stufen-Zulassungsliste prüfen
PAIR_NOT_FOUND	Anfrage	Nein	Paar-Symbol überprüfen
TIMEFRAME_NOT_SUPPORTED	Anfrage	Nein	Unterstützten Timeframe verwenden
INVALID_PARAMETER	Anfrage	Nein	Parameter korrigieren
MISSING_PARAMETER	Anfrage	Nein	Parameter hinzufügen
EXCHANGE_UNAVAILABLE	Upstream	Ja	Kurzer Wiederholungsversuch
DATA_UNAVAILABLE	Upstream	Ja	Verzögerung dann erneut versuchen
INTERNAL_ERROR	Server	Einmal	Melden, falls anhaltend
SERVICE_UNAVAILABLE	Server	Ja	Verzögerung dann erneut versuchen