Orderbook Tool-Referenz

Diese Seite ist die Tool-Referenz zum Abrufen von Orderbuch-Snapshots aus dem Cryptohopper Market Data MCP. Für die konzeptionelle Anleitung siehe einen praktischen Leitfaden zu Krypto-Orderbuch-Daten.

Tool-Name

get_orderbook

Zweck

Gibt einen Zeitpunkt-Snapshot des Orderbuchs für ein bestimmtes Paar an einer bestimmten Börse zurück. Enthält die aktuellen ruhenden Gebote und Angebote mit Preis und Größe pro Level.

Argumente

Argument	Typ	Erforderlich	Beschreibung
exchange	string	Ja	Börsen-Kennung (Kleinbuchstaben).
pair	string	Ja	Paar im BASE/QUOTE-Format (z.B. BTC/USDT).
depth	integer	Nein	Maximale Anzahl der Levels, die pro Seite zurückgegeben werden. Standard ist börsenabhängig. Obergrenze ist upstream-abhängig.

Response-Schema

{
  "exchange": "binance",
  "pair": "BTC/USDT",
  "timestamp": "2026-04-24T14:03:00Z",
  "bids": [
    [80934.18, 5.32816],
    [80930.05, 1.10000],
    [80925.40, 3.40000]
  ],
  "asks": [
    [80936.22, 1.20000],
    [80940.00, 2.50000],
    [80945.75, 0.80000]
  ]
}

Felder

Feld	Typ	Beschreibung
exchange	string	Die Börsen-Kennung, von der die Daten stammen.
pair	string	Das Paar im BASE/QUOTE-Format.
timestamp	string (ISO-8601)	Erfassungszeit des Snapshots.
bids	array	Array von [Preis, Größe]-Tupeln, sortiert nach Preis absteigend (höchstes Gebot zuerst).
asks	array	Array von [Preis, Größe]-Tupeln, sortiert nach Preis aufsteigend (niedrigstes Gebot zuerst).

Preise und Größen werden als JSON-Zahlen zurückgegeben. Clients, die exakte Präzision für ausführungsbezogene Berechnungen benötigen, sollten sie unmittelbar nach dem Parsen in einen Dezimaltyp konvertieren. Siehe Datenmodell für Konventionen.

Sortierung

• bids sind nach Preis absteigend sortiert. Der erste Eintrag ist das beste Gebot (höchster Preis, den ein Käufer bietet).
• asks sind nach Preis aufsteigend sortiert. Der erste Eintrag ist das niedrigste Gebot (niedrigster Preis, den ein Verkäufer anbietet).

Der Spread ist die Differenz zwischen asks[0] und bids[0]. Der Mittelpunkt ist ihr Durchschnitt.

Tiefe

Die Orderbuch-Tiefe variiert je nach Börse. Das MCP gibt zurück, was die Upstream-Börse über ihre öffentliche API bereitstellt.

Typische Tiefe (Levels pro Seite)	Börsen
100	Die meisten großen Börsen standardmäßig
Bis zu 500 oder mehr	Einige Börsen, wenn Tiefe angefordert wird

Anfragen für mehr Tiefe als die Upstream-Börse unterstützt, werden auf das Upstream-Maximum begrenzt. Das depth-Argument ist Best-Effort, nicht garantiert.

Aktualität

Orderbücher werden zum Anfragezeitpunkt erfasst. Das timestamp-Feld gibt an, wann der Snapshot von der Upstream-Börse gelesen wurde.

Orderbücher werden sehr schnell veraltet — typischerweise innerhalb von Sekunden bei liquiden Paaren. Clients sollten Orderbuch-Antworten nicht für Ausführungsentscheidungen zwischenspeichern.

Kosten

Aspekt	Kosten
Pro Aufruf	1 Call-Einheit auf allen Tarifen
Historische Variante	Nicht unterstützt — Orderbuch-Historie ist nicht über das MCP verfügbar

Beispielaufrufe

Basis-Snapshot

Eingegeben in einem MCP-Client:

Zeig mir das aktuelle Orderbuch für BTC/USDT auf Binance.

Der Agent ruft get_orderbook(exchange="binance", pair="BTC/USDT") auf und gibt einen Snapshot zurück.

Benutzerdefinierte Tiefe

Ziehe die obersten 50 Levels des ETH/USDT-Orderbuchs auf Kraken.

Der Agent ruft get_orderbook(exchange="kraken", pair="ETH/USDT", depth=50) auf.

Abgeleitete Metriken

Das MCP gibt rohe Levels zurück; abgeleitete Metriken (Spread, Tiefe innerhalb von X%, Slippage für eine gegebene Order-Größe) werden vom Modell oder vom aufrufenden Code berechnet.

Fehler

Fehlercode	Ursache
UNAUTHORIZED	API-Schlüssel ungültig oder widerrufen.
EXCHANGE_NOT_SUPPORTED	Börse nicht verfügbar auf dem aktiven Tarif.
PAIR_NOT_FOUND	Paar existiert nicht auf der angegebenen Börse.
INVALID_PARAMETER	Argument hat Validierung nicht bestanden (z.B. fehlerhaftes Paar-Symbol, negative Tiefe).
EXCHANGE_UNAVAILABLE	Upstream-Börse antwortet nicht.
RATE_LIMIT_EXCEEDED	Rate-Limit für kurze Intervalle erreicht.
QUOTA_EXCEEDED	Wöchentliche Quota erreicht.

Tarif-Zugang

Orderbuch-Abfragen sind auf allen Tarifen verfügbar (Pioneer, Explorer, Adventurer, Hero).

Die Börsen-Abdeckungsbeschränkung gilt: Auf Pioneer sind Orderbuch-Abfragen auf Binance, Coinbase und Kraken beschränkt. Auf Explorer und darüber sind weitere Börsen verfügbar.