Referencia de la herramienta Ticker

Esta página es la referencia de la herramienta para recuperar instantáneas de ticker del MCP de Datos de Mercado de Cryptohopper.

Nombre de la herramienta

get_ticker

Propósito

Devuelve un resumen puntual del estado actual de un mercado para un par especificado en un exchange especificado. Incluye el último precio negociado, mejor oferta y demanda, rango de 24 horas, volumen de 24 horas y cambio de 24 horas.

Argumentos

Argumento	Tipo	Requerido	Descripción
exchange	string	Sí	Identificador del exchange (minúsculas).
pair	string	Sí	Par en formato BASE/QUOTE (ej. BTC/USDT).

Esquema de respuesta

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

Campos

Campo	Tipo	Descripción
exchange	string	El identificador del exchange del cual provienen los datos.
pair	string	El par, en formato BASE/QUOTE.
timestamp	string (ISO-8601)	Hora de captura de la instantánea.
last	number	Último precio negociado.
bid	number	Mejor precio de oferta.
ask	number	Mejor precio de demanda.
bidVolume	number	Tamaño disponible en la mejor oferta. Puede estar ausente en algunos exchanges.
askVolume	number	Tamaño disponible en la mejor demanda. Puede estar ausente en algunos exchanges.
high	number	Precio de negociación más alto en las últimas 24 horas.
low	number	Precio de negociación más bajo en las últimas 24 horas.
open	number	Precio de apertura de la ventana actual de 24 horas.
close	number	Precio de cierre de la ventana actual de 24 horas. Típicamente igual a last.
previousClose	number	Precio de cierre de la ventana anterior de 24 horas. Puede estar ausente en algunos exchanges.
average	number	Promedio de apertura y cierre. Puede estar ausente en algunos exchanges.
vwap	number	Precio promedio ponderado por volumen de 24 horas. Puede estar ausente en algunos exchanges.
baseVolume	number	Volumen de 24 horas en el activo base.
quoteVolume	number	Volumen de 24 horas en el activo de cotización. Puede estar ausente en algunos exchanges.
change	number	Cambio absoluto de precio en las últimas 24 horas (last ? open).
percentage	number	Cambio porcentual en las últimas 24 horas.

Los precios y tamaños se devuelven como números JSON. Los clientes que requieran precisión exacta para cálculos relacionados con la ejecución deben convertirlos a un tipo decimal inmediatamente después del análisis. Consulta el modelo de datos para conocer las convenciones.

Métricas derivadas

El esquema del ticker es intencionalmente compacto. Las métricas derivadas se calculan del lado del cliente:

Métrica	Cálculo
Spread (absoluto)	ask ? bid
Spread (puntos básicos)	(ask ? bid) / punto medio × 10_000
Punto medio	(bid + ask) / 2

El modelo o tu código realizan estos cálculos después de que se devuelve el ticker. No se necesita ninguna llamada adicional a la herramienta.

Actualización

Las respuestas del ticker reflejan el estado actual del exchange ascendente en el momento de la solicitud. El campo timestamp registra cuándo se capturó la instantánea.

Los datos del exchange subyacente se actualizan muchas veces por segundo. El MCP no expone un modo de ticker en streaming; cada invocación es una obtención puntual fresca. Para la mayoría de los flujos de trabajo de agentes de IA, actualizar los tickers cada pocos segundos o minutos es apropiado. Para datos tick por tick, un websocket del exchange es la herramienta correcta — esto no es para lo que está diseñado el MCP.

Costo

Aspecto	Costo
Por invocación	1 unidad de llamada en todos los niveles
Variante histórica	No compatible — el historial de ticker no está disponible a través del MCP. Para análisis de series temporales, usa get_candles.

Características de escalamiento

Las llamadas de ticker son el tipo de datos más económico y rápido en el MCP. Patrones de uso típicos:

• Escaneos amplios. Obtener tickers de los 200 pares principales de un exchange consume 200 unidades de llamada — bien dentro de la cuota semanal de cada nivel.
• Comparación entre exchanges. Obtener el mismo par en 5 exchanges son 5 unidades de llamada.
• Barridos de lista de observación. Una lista de observación de 20 pares actualizada cada hora son 480 llamadas por día, 3,360 por semana — encaja cómodamente en el nivel gratuito Pioneer.

Para el patrón de diseño que aprovecha la economía del ticker, consulta patrones de prompts y una guía práctica de datos de ticker.

Ejemplos de invocaciones

Instantánea básica

Solicitado en un cliente MCP:

¿Cuál es el ticker actual de BTC/USDT en Binance?

El agente invoca get_ticker(exchange="binance", pair="BTC/USDT") y devuelve la instantánea.

Comparación entre exchanges

Compara los tickers de BTC/USDT en Binance, Coinbase, Kraken y OKX. ¿Cuál tiene el spread más estrecho ahora mismo?

El agente invoca get_ticker cuatro veces, una por exchange, calcula los spreads localmente y devuelve una clasificación.

Barrido de lista de observación

Para cada uno de BTC, ETH, SOL, ARB, OP, obtén el ticker actual de Binance y resume en una tabla.

El agente invoca get_ticker cinco veces y presenta los resultados en forma tabular.

Errores

Código de error	Causa
UNAUTHORIZED	Clave api inválida o revocada.
EXCHANGE_NOT_SUPPORTED	Exchange no disponible en el nivel activo.
PAIR_NOT_FOUND	El par no existe en el exchange especificado.
INVALID_PARAMETER	El argumento falló la validación (ej. símbolo de par mal formado).
EXCHANGE_UNAVAILABLE	Exchange ascendente no responde.
RATE_LIMIT_EXCEEDED	Límite de tasa de intervalo corto alcanzado.
QUOTA_EXCEEDED	Cuota semanal alcanzada.

Acceso por nivel

Las consultas de ticker están disponibles en todos los niveles (Pioneer, Explorer, Adventurer, Hero).

Se aplica la restricción de cobertura de exchange: en Pioneer, las consultas de ticker están limitadas a Binance, Coinbase y Kraken. En Explorer y superiores, hay más exchanges disponibles. Consulta exchanges compatibles.