Ticker-Tool-Referenz

Diese Seite ist die Tool-Referenz zum Abrufen von Ticker-Snapshots aus dem Cryptohopper Market Data MCP.

Tool-Name

get_ticker

Zweck

Gibt eine zeitpunktbezogene Zusammenfassung des aktuellen Zustands eines Marktes für ein bestimmtes Paar auf einer bestimmten Börse zurück. Beinhaltet den zuletzt gehandelten Preis, bestes Gebot und beste Nachfrage, 24-Stunden-Spanne, 24-Stunden-Volumen und 24-Stunden-Veränderung.

Argumente

Argument	Typ	Erforderlich	Beschreibung
exchange	string	Ja	Börsen-Identifikator (Kleinbuchstaben).
pair	string	Ja	Paar im BASE/QUOTE-Format (z. B. BTC/USDT).

Response-Schema

{
  "exchange": "binance",
  "pair": "BTC/USDT",
  "timestamp": "2026-04-24T14:03:00Z",
  "last": 80934.19,
  "bid": 80932.50,
  "ask": 80936.22,
  "bidVolume": 1.10500,
  "askVolume": 1.32000,
  "high": 81920.00,
  "low": 80120.00,
  "open": 80214.00,
  "close": 80934.19,
  "previousClose": 80214.00,
  "average": 80574.10,
  "vwap": 80651.42,
  "baseVolume": 11744.6152,
  "quoteVolume": 946812440.18,
  "change": 720.19,
  "percentage": 0.90
}

Felder

Feld	Typ	Beschreibung
exchange	string	Der Börsen-Identifikator, von dem die Daten stammen.
pair	string	Das Paar im BASE/QUOTE-Format.
timestamp	string (ISO-8601)	Erfassungszeit des Snapshots.
last	number	Zuletzt gehandelter Preis.
bid	number	Bester Gebotspreis.
ask	number	Bester Angebotspreis.
bidVolume	number	Größe beim besten Gebot. Kann bei einigen Börsen fehlen.
askVolume	number	Größe beim besten Angebot. Kann bei einigen Börsen fehlen.
high	number	Höchster Handelspreis in den letzten 24 Stunden.
low	number	Niedrigster Handelspreis in den letzten 24 Stunden.
open	number	Eröffnungspreis des aktuellen 24-Stunden-Fensters.
close	number	Schlusskurs des aktuellen 24-Stunden-Fensters. Normalerweise gleich last.
previousClose	number	Schlusskurs des vorherigen 24-Stunden-Fensters. Kann bei einigen Börsen fehlen.
average	number	Durchschnitt von open und close. Kann bei einigen Börsen fehlen.
vwap	number	24-Stunden-volumengewichteter Durchschnittspreis. Kann bei einigen Börsen fehlen.
baseVolume	number	24-Stunden-Volumen im Basis-Asset.
quoteVolume	number	24-Stunden-Volumen im Kurs-Asset. Kann bei einigen Börsen fehlen.
change	number	Absolute Preisveränderung über die letzten 24 Stunden (last - open).
percentage	number	Prozentuale Veränderung über die letzten 24 Stunden.

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 umwandeln. Siehe Datenmodell für Konventionen.

Abgeleitete Metriken

Das Ticker-Schema ist absichtlich kompakt. Abgeleitete Metriken werden clientseitig berechnet:

Metrik	Berechnung
Spread (absolut)	ask - bid
Spread (Basispunkte)	(ask - bid) / midpoint × 10_000
Midpoint	(bid + ask) / 2

Das Modell oder dein Code führt diese Berechnungen durch, nachdem der Ticker zurückgegeben wurde. Es ist kein zusätzlicher Tool-Aufruf erforderlich.

Aktualität

Ticker-Antworten spiegeln den aktuellen Zustand der Upstream-Börse zum Zeitpunkt der Anfrage wider. Das timestamp-Feld zeichnet auf, wann der Snapshot erfasst wurde.

Die zugrunde liegenden Börsendaten werden viele Male pro Sekunde aktualisiert. Das MCP bietet keinen Streaming-Ticker-Modus; jeder Aufruf ist ein frischer zeitpunktbezogener Abruf. Für die meisten KI-Agenten-Workflows ist das Aktualisieren von Tickern alle paar Sekunden bis Minuten angemessen. Für Tick-für-Tick-Daten ist ein Börsen-Websocket das richtige Tool — dafür ist das MCP nicht konzipiert.

Kosten

Aspekt	Kosten
Pro Aufruf	1 Call-Einheit auf allen Stufen
Historische Variante	Nicht unterstützt — Ticker-Historie ist über das MCP nicht verfügbar. Für Zeitreihenanalyse verwende get_candles.

Skalierungsmerkmale

Ticker-Aufrufe sind der günstigste und schnellste Datentyp im MCP. Typische Nutzungsmuster:

• Breite Scans. Das Abrufen von Tickern über die Top-200-Paare einer Börse verbraucht 200 Call-Einheiten — weit innerhalb des wöchentlichen Kontingents jeder Stufe.
• Mehrbörsen-Vergleich. Das Abrufen desselben Paares über 5 Börsen sind 5 Call-Einheiten.
• Watchlist-Sweeps. Eine 20-Paar-Watchlist, die stündlich aktualisiert wird, sind 480 Aufrufe pro Tag, 3.360 pro Woche — passt bequem in die kostenlose Pioneer-Stufe.

Für das Designmuster, das die Günstigkeit von Tickern ausnutzt, siehe Prompt-Muster und einen praktischen Leitfaden zu Ticker-Daten.

Beispielaufrufe

Basis-Snapshot

Eingegeben in einem MCP-Client:

Wie lautet der aktuelle BTC/USDT-Ticker auf Binance?

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

Börsenübergreifender Vergleich

Vergleiche BTC/USDT-Ticker auf Binance, Coinbase, Kraken und OKX. Welcher hat gerade den engsten Spread?

Der Agent ruft get_ticker viermal auf, einmal pro Börse, berechnet Spreads lokal und gibt ein Ranking zurück.

Watchlist-Sweep

Rufe für jedes von BTC, ETH, SOL, ARB, OP den aktuellen Ticker von Binance ab und fasse ihn in einer Tabelle zusammen.

Der Agent ruft get_ticker fünfmal auf und präsentiert die Ergebnisse in Tabellenform.

Fehler

Fehlercode	Ursache
UNAUTHORIZED	API-Schlüssel ungültig oder widerrufen.
EXCHANGE_NOT_SUPPORTED	Börse nicht auf der aktiven Stufe verfügbar.
PAIR_NOT_FOUND	Paar existiert nicht auf der angegebenen Börse.
INVALID_PARAMETER	Argument hat Validierung nicht bestanden (z. B. fehlerhaftes Paar-Symbol).
EXCHANGE_UNAVAILABLE	Upstream-Börse antwortet nicht.
RATE_LIMIT_EXCEEDED	Kurzintervall-Ratenlimit erreicht.
QUOTA_EXCEEDED	Wöchentliches Kontingent erreicht.

Stufenzugang

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

Die Börsenabdeckungs-Beschränkung gilt: Auf Pioneer sind Ticker-Abfragen auf Binance, Coinbase und Kraken beschränkt. Auf Explorer und höher sind mehr Börsen verfügbar. Siehe unterstützte Börsen.