Riferimento tool ticker

Questa pagina è il riferimento del tool per recuperare snapshot di ticker dal Cryptohopper Market Data MCP.

Nome dello strumento

get_ticker

Scopo

Restituisce un riepilogo puntuale dello stato corrente di un mercato per una coppia specificata su un exchange specificato. Include l'ultimo prezzo scambiato, miglior offerta e richiesta, intervallo 24 ore, volume 24 ore e variazione 24 ore.

Argomenti

Argomento	Tipo	Obbligatorio	Descrizione
exchange	string	Sì	Identificativo exchange (minuscolo).
pair	string	Sì	Coppia in formato BASE/QUOTE (es. BTC/USDT).

Schema della risposta

{
  "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
}

Campi

Campo	Tipo	Descrizione
exchange	string	L'identificativo exchange da cui provengono i dati.
pair	string	La coppia, in formato BASE/QUOTE.
timestamp	string (ISO-8601)	Momento di acquisizione dello snapshot.
last	number	Ultimo prezzo scambiato.
bid	number	Miglior prezzo di offerta.
ask	number	Miglior prezzo di richiesta.
bidVolume	number	Quantità disponibile alla miglior offerta. Può essere assente su alcuni exchange.
askVolume	number	Quantità disponibile alla miglior richiesta. Può essere assente su alcuni exchange.
high	number	Prezzo di scambio più alto nelle ultime 24 ore.
low	number	Prezzo di scambio più basso nelle ultime 24 ore.
open	number	Prezzo di apertura della finestra corrente di 24 ore.
close	number	Prezzo di chiusura della finestra corrente di 24 ore. Tipicamente uguale a last.
previousClose	number	Prezzo di chiusura della finestra precedente di 24 ore. Può essere assente su alcuni exchange.
average	number	Media di open e close. Può essere assente su alcuni exchange.
vwap	number	Prezzo medio ponderato per volume delle 24 ore. Può essere assente su alcuni exchange.
baseVolume	number	Volume 24 ore nell'asset base.
quoteVolume	number	Volume 24 ore nell'asset di quotazione. Può essere assente su alcuni exchange.
change	number	Variazione assoluta del prezzo nelle ultime 24 ore (last - open).
percentage	number	Variazione percentuale nelle ultime 24 ore.

Prezzi e quantità sono restituiti come numeri JSON. I client che richiedono precisione esatta per calcoli relativi all'esecuzione dovrebbero convertirli immediatamente in un tipo decimale dopo il parsing. Vedi il modello dati per le convenzioni.

Metriche derivate

Lo schema del ticker è intenzionalmente compatto. Le metriche derivate vengono calcolate lato client:

Metrica	Calcolo
Spread (assoluto)	ask - bid
Spread (punti base)	(ask - bid) / midpoint × 10_000
Punto medio	(bid + ask) / 2

Il modello o il tuo codice esegue questi calcoli dopo che il ticker è stato restituito. Non è necessaria alcuna chiamata tool aggiuntiva.

Aggiornamento

Le risposte del ticker riflettono lo stato corrente dell'exchange upstream al momento della richiesta. Il campo timestamp registra quando lo snapshot è stato acquisito.

I dati dell'exchange sottostante si aggiornano molte volte al secondo. L'MCP non espone una modalità ticker in streaming; ogni invocazione è un recupero puntuale aggiornato. Per la maggior parte dei flussi di lavoro degli agenti AI, aggiornare i ticker ogni pochi secondi o minuti è appropriato. Per dati tick-by-tick, un websocket dell'exchange è lo strumento corretto — questo non è ciò per cui l'MCP è progettato.

Costo

Aspetto	Costo
Per invocazione	1 unità di chiamata su tutti i livelli
Variante storica	Non supportata — la cronologia dei ticker non è disponibile tramite l'MCP. Per l'analisi delle serie temporali, usa get_candles.

Caratteristiche di scalabilità

Le chiamate ticker sono il tipo di dati più economico e veloce nell'MCP. Modelli di utilizzo tipici:

• Scansioni ampie. Recuperare i ticker delle prime 200 coppie di un exchange consuma 200 unità di chiamata — ben all'interno della quota settimanale di ogni livello.
• Confronto multi-exchange. Recuperare la stessa coppia su 5 exchange è 5 unità di chiamata.
• Sweep delle watchlist. Una watchlist di 20 coppie aggiornata ogni ora è 480 chiamate al giorno, 3.360 a settimana — si adatta comodamente al livello gratuito Pioneer.

Per il modello di progettazione che sfrutta l'economicità dei ticker, vedi i modelli di prompt e una guida pratica ai dati ticker.

Esempi di invocazione

Snapshot di base

Richiesto in un client MCP:

Qual è il ticker BTC/USDT attuale su Binance?

L'agente invoca get_ticker(exchange="binance", pair="BTC/USDT") e restituisce lo snapshot.

Confronto tra exchange

Confronta i ticker BTC/USDT su Binance, Coinbase, Kraken e OKX. Quale ha lo spread più stretto in questo momento?

L'agente invoca get_ticker quattro volte, una per exchange, calcola gli spread localmente e restituisce una classifica.

Sweep watchlist

Per ciascuno di BTC, ETH, SOL, ARB, OP, recupera il ticker corrente da Binance e riassumi in una tabella.

L'agente invoca get_ticker cinque volte e presenta i risultati in forma tabellare.

Errori

Codice errore	Causa
UNAUTHORIZED	Chiave API non valida o revocata.
EXCHANGE_NOT_SUPPORTED	Exchange non disponibile sul livello attivo.
PAIR_NOT_FOUND	La coppia non esiste sull'exchange specificato.
INVALID_PARAMETER	L'argomento non ha superato la validazione (es. simbolo coppia malformato).
EXCHANGE_UNAVAILABLE	Exchange upstream non risponde.
RATE_LIMIT_EXCEEDED	Limite di frequenza a breve intervallo raggiunto.
QUOTA_EXCEEDED	Quota settimanale raggiunta.

Accesso per livello

Le query ticker sono disponibili su tutti i livelli (Pioneer, Explorer, Adventurer, Hero).

Si applica la restrizione di copertura degli exchange: su Pioneer, le query ticker sono limitate a Binance, Coinbase e Kraken. Su Explorer e superiori, sono disponibili più exchange. Vedi exchange supportati.