Rate-Limits und Kostenfaktoren

Diese Seite dokumentiert, wie die Cryptohopper Market Data MCP Aufrufe zählt, Rate-Limits anwendet und Kostenmultiplikatoren für historische Daten berechnet. Es handelt sich um die technische Referenz; für die Tier-Übersicht siehe Abonnement-Tiers.

Zwei unabhängige Limits

Die MCP wendet zwei separate Limits auf jedes Konto an:

• Wöchentliches Aufruf-Limit. Ein rollendes wöchentliches Kontingent von Aufrufen, tier-spezifisch.
• Rate-Limit. Eine Kurzintervall-Obergrenze dafür, wie schnell Aufrufe gemacht werden können.

Beide Limits werden pro Konto angewendet. Das Erstellen zusätzlicher API-Schlüssel multipliziert keines der beiden Limits.

Wöchentliches Anruf-Limit

Tier	Wöchentliche Aufrufe
Pioneer	6.000
Explorer	30.000
Adventurer	150.000
Hero	1.250.000

Der Zähler wird jeden Freitag zu einem festen Zeitpunkt pro Konto zurückgesetzt. Das Überschreiten des Limits gibt einen QUOTA_EXCEEDED-Fehler zurück, bis zum nächsten Reset.

Die aktuelle Nutzung und die Zeit bis zum Reset können jederzeit abgefragt werden. Siehe Nutzung und Limits.

Rate-Limit

Zusätzlich zum wöchentlichen Limit verhindert ein Kurzintervall-Rate-Limit schnelle Bursts. Das genaue Zeitfenster und der Schwellenwert werden einheitlich über alle Tiers hinweg angewendet und können ohne Vorankündigung angepasst werden, um die Service-Stabilität aufrechtzuerhalten.

Das Überschreiten des Rate-Limits gibt einen RATE_LIMIT_EXCEEDED-Fehler zurück. Ein erneuter Versuch nach kurzer Verzögerung ist in der Regel erfolgreich.

Hinweis: Wenn dein Workflow viele sequenzielle Aufrufe beinhaltet (zum Beispiel das Durchsuchen von Tickern über alle Paare auf einer Börse), füge eine kleine Verzögerung zwischen den Aufrufen hinzu — in der Größenordnung von Dutzenden bis Hunderten von Millisekunden —, um unter dem Rate-Limit zu bleiben. MCP-Clients tun dies in den meisten Fällen automatisch.

Kosteneinheit

Eine Aufrufeinheit ist die Basisgebühr für einen einzelnen Tool-Aufruf. Das wöchentliche Aufruf-Limit wird in Einheiten ausgedrückt.

Die meisten Tool-Aufrufe zählen als 1 Einheit. Historische Candle-Abfragen können als mehr als 1 Einheit zählen, wie unten beschrieben.

Kostenfaktor: Historische Daten

Historische Candle-Abfragen haben einen Kostenmultiplikator auf den Explorer- und Adventurer-Tiers. Der Multiplikator hängt von der Rückblick-Tiefe ab:

Rückblick-Tiefe	Kostenmultiplikator
Kurze Historie (aktuelle Bars innerhalb eines kurzen Zeitraums)	5×
Lange Historie (Bars, die bis zur maximalen Historie des Tiers reichen)	20×

Die Grenze zwischen "kurz" und "lang" ist tier-spezifisch und kann angepasst werden. Als Faustregel werden Abfragen, die ungefähr die letzten ~10% der historischen Zulassung des Tiers abrufen, mit 5× berechnet; tiefere Abfragen werden mit 20× berechnet.

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.

Beispiele

Abfrage	Tier	Einheitskosten
Aktueller BTC/USDT-Ticker auf Binance	Beliebig	1
Vollständiger Orderbuch-Snapshot für ETH/USDT auf Kraken	Beliebig	1
Letzte 100 × 1h-Candles für SOL/USDT auf Binance (aktuell)	Explorer	5
Letzte 500 × 1h-Candles mit Rückblick ~3 Wochen	Explorer	5
Letzte 1.000 × 1h-Candles mit Rückblick zum 90-Tage-Limit	Explorer	20
Letzte 1.000 × 4h-Candles (tiefer Rückblick)	Adventurer	20
Letzte 3.000 × 1h-Candles (3-Jahres-Rückblick)	Hero	1

Die genauen Kosten einer bestimmten Abfrage können durch Aufrufen des Nutzungs-Endpunkts nach der Abfrage vorgeschaut werden — das Delta in calls_used sind die Einheitskosten.

Budgetierungshinweise

Ein paar Faustregeln, um innerhalb des Kontingents zu bleiben:

• Bevorzuge Ticker für breite Scans. Ein 200-Paar-Ticker-Sweep kostet 200 Einheiten. Der gleiche Sweep über Orderbücher kostet 200 Einheiten (obwohl jeder Aufruf viel mehr Daten überträgt). Der gleiche Sweep über tiefe Candle-Historie kann Tausende von Einheiten kosten.
• Halte den Candle-Rückblick eng. Die meisten Indikatoren (RSI, MACD, gleitende Durchschnitte bis zu 200-Perioden) benötigen nicht mehr als 150-200 Candles Kontext. Das standardmäßige Abrufen von 1.000 Candles ist die häufigste Ursache für unnötigen Kontingent-Verbrauch.
• Cache, wo es Sinn macht. Orderbücher werden innerhalb von Sekunden veraltet, daher ist das Cachen von Orderbuch-Snapshots selten nützlich. Candle-Daten, die älter als die aktuelle Bar sind, sind unveränderlich, daher ist das Cachen oder Speichern historischer Candles angemessen.
• Nutze Hero, wenn historische Tiefe strukturell erforderlich ist. Wenn dein Workflow routinemäßig lange Candle-Historien abruft, ist der flache 1×-Kostenfaktor auf Hero in der Regel wirtschaftlicher, als die gleichen Daten auf Adventurer mit 20× abzurufen.

Kontingent für Multi-Agent-Deployments

Wenn mehrere Agenten ein Konto teilen, schöpfen alle Agenten aus dem gleichen wöchentlichen Kontingent. Um Agenten zu trennen:

• Erstelle zusätzliche API-Schlüssel (innerhalb der Key-Zulassung des Tiers). Jeder Schlüssel verbraucht aus dem gemeinsamen Kontingent, kann aber unabhängig widerrufen oder rotiert werden.
• Implementiere Anwendungsebenen-Drosselung pro Schlüssel, um zu verhindern, dass ein Agent das Kontingent für andere erschöpft.

Siehe wie du mehrere Agenten mit mehreren API-Schlüsseln laufen lässt für Muster.

Fehlerbehandlung

Limit-bezogene Fehler, die von der MCP zurückgegeben werden:

Fehlercode	Bedeutung
QUOTA_EXCEEDED	Wöchentliches Aufruf-Limit erreicht. Setzt zum nächsten Reset-Zeitpunkt zurück.
RATE_LIMIT_EXCEEDED	Kurzintervall-Rate-Limit getroffen. Versuche es nach kurzer Verzögerung erneut.
HISTORY_LIMIT_EXCEEDED	Angeforderter Rückblick überschreitet die maximale Historie des Tiers.
EXCHANGE_NOT_SUPPORTED	Angeforderte Börse ist nicht in der Zulassungsliste des Tiers.

Vollständige Fehlerreferenz: Fehlerreferenz.

Aktuelle Nutzung prüfen

Die MCP stellt ein Nutzungsprüfungs-Tool bereit, das Folgendes zurückgibt:

• tier — der aktive Abonnement-Tier.
• calls_used — verbrauchte Einheiten im aktuellen wöchentlichen Zyklus.
• calls_limit — das wöchentliche Limit des Tiers.
• reset_at — ISO-8601-Zeitstempel des nächsten Resets.