Referência da ferramenta ticker

Esta página é a referência da ferramenta para recuperar snapshots de ticker do Cryptohopper Market Data MCP.

Nome da ferramenta

get_ticker

Finalidade

Retorna um resumo pontual do estado atual de um mercado para um par especificado em uma corretora especificada. Inclui o último preço negociado, melhor oferta de compra e venda, faixa de 24 horas, volume de 24 horas e variação de 24 horas.

Argumentos

Argumento	Tipo	Obrigatório	Descrição
exchange	string	Sim	Identificador da corretora (minúsculas).
pair	string	Sim	Par no formato BASE/COTAÇÃO (ex: BTC/USDT).

Esquema de resposta

{
  "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	Descrição
exchange	string	O identificador da corretora de onde vieram os dados.
pair	string	O par, no formato BASE/COTAÇÃO.
timestamp	string (ISO-8601)	Momento de captura do snapshot.
last	number	Último preço negociado.
bid	number	Melhor preço de oferta de compra.
ask	number	Melhor preço de oferta de venda.
bidVolume	number	Tamanho disponível na melhor oferta de compra. Pode estar ausente em algumas corretoras.
askVolume	number	Tamanho disponível na melhor oferta de venda. Pode estar ausente em algumas corretoras.
high	number	Maior preço negociado nas últimas 24 horas.
low	number	Menor preço negociado nas últimas 24 horas.
open	number	Preço de abertura da janela atual de 24 horas.
close	number	Preço de fechamento da janela atual de 24 horas. Normalmente igual ao último preço.
previousClose	number	Preço de fechamento da janela anterior de 24 horas. Pode estar ausente em algumas corretoras.
average	number	Média de abertura e fechamento. Pode estar ausente em algumas corretoras.
vwap	number	Preço médio ponderado por volume de 24 horas. Pode estar ausente em algumas corretoras.
baseVolume	number	Volume de 24 horas no ativo de base.
quoteVolume	number	Volume de 24 horas no ativo de cotação. Pode estar ausente em algumas corretoras.
change	number	Variação absoluta de preço nas últimas 24 horas (último - abertura).
percentage	number	Variação percentual nas últimas 24 horas.

Preços e tamanhos são retornados como números JSON. Clientes que exigem precisão exata para cálculos relacionados à execução devem convertê-los para um tipo decimal imediatamente após a análise. Consulte o modelo de dados para convenções.

Métricas derivadas

O esquema do ticker é intencionalmente compacto. Métricas derivadas são calculadas no lado do cliente:

Métrica	Cálculo
Spread (absoluto)	ask - bid
Spread (pontos-base)	(ask - bid) / ponto médio × 10_000
Ponto médio	(bid + ask) / 2

O modelo ou seu código realiza esses cálculos após o ticker ser retornado. Nenhuma chamada adicional de ferramenta é necessária.

Atualização

As respostas de ticker refletem o estado atual da corretora upstream no momento da requisição. O campo timestamp registra quando o snapshot foi capturado.

Os dados da corretora subjacente são atualizados muitas vezes por segundo. O MCP não expõe um modo de ticker em streaming; cada invocação é uma nova busca pontual. Para a maioria dos fluxos de trabalho de agentes de IA, atualizar tickers a cada poucos segundos ou minutos é apropriado. Para dados tick por tick, um websocket da corretora é a ferramenta correta — não é para isso que o MCP foi projetado.

Custo

Aspecto	Custo
Por invocação	1 unidade de chamada em todos os planos
Variante histórica	Não suportado — histórico de ticker não está disponível através do MCP. Para análise de série temporal, use get_candles.

Características de escalabilidade

Chamadas de ticker são o tipo de dados mais barato e rápido no MCP. Padrões de uso típicos:

• Varreduras amplas. Buscar tickers dos 200 principais pares de uma corretora consome 200 unidades de chamada — bem dentro da cota semanal de todos os planos.
• Comparação entre corretoras. Buscar o mesmo par em 5 corretoras são 5 unidades de chamada.
• Varreduras de watchlist. Uma watchlist de 20 pares atualizada a cada hora representa 480 chamadas por dia, 3.360 por semana — cabe confortavelmente no plano gratuito Pioneer.

Para o padrão de design que explora a economia dos tickers, consulte padrões de prompt e um guia prático para dados de ticker.

Exemplos de invocações

Snapshot básico

Solicitado em um cliente MCP:

Qual é o ticker atual de BTC/USDT na Binance?

O agente invoca get_ticker(exchange="binance", pair="BTC/USDT") e retorna o snapshot.

Comparação entre corretoras

Compare os tickers de BTC/USDT na Binance, Coinbase, Kraken e OKX. Qual tem o spread mais apertado agora?

O agente invoca get_ticker quatro vezes, uma por corretora, calcula os spreads localmente e retorna um ranking.

Varredura de watchlist

Para cada uma de BTC, ETH, SOL, ARB, OP, busque o ticker atual da Binance e resuma em uma tabela.

O agente invoca get_ticker cinco vezes e apresenta os resultados em formato tabular.

Erros

Código de erro	Causa
UNAUTHORIZED	Chave de API inválida ou revogada.
EXCHANGE_NOT_SUPPORTED	Corretora não disponível no plano ativo.
PAIR_NOT_FOUND	Par não existe na corretora especificada.
INVALID_PARAMETER	Argumento falhou na validação (ex: símbolo de par malformado).
EXCHANGE_UNAVAILABLE	Corretora upstream não está respondendo.
RATE_LIMIT_EXCEEDED	Limite de taxa de curto intervalo atingido.
QUOTA_EXCEEDED	Cota semanal atingida.

Acesso por plano

Consultas de ticker estão disponíveis em todos os planos (Pioneer, Explorer, Adventurer, Hero).

A restrição de cobertura de corretoras se aplica: no Pioneer, consultas de ticker são limitadas a Binance, Coinbase e Kraken. No Explorer e superiores, mais corretoras estão disponíveis. Consulte corretoras suportadas.