Pré-requisitos
O Cryptohopper MCP configurado em um cliente MCP. Veja a visão geral da configuração.
Pelo menos uma chave de API na sua conta Cryptohopper. Veja como obter uma chave de API do Cryptohopper MCP.
Configuração
Abra seu cliente MCP.
Peça diretamente ao cliente o uso.
Qualquer uma das seguintes perguntas roteará para a ferramenta de inspeção de uso do MCP:
Qual parte da minha cota do Cryptohopper MCP usei esta semana?
Qual é o meu nível atual do Cryptohopper MCP e o uso de chamadas?
Mostre-me meu uso do Cryptohopper MCP: nível, chamadas usadas, chamadas restantes e a próxima hora de reinício.A resposta inclui:
Nível de assinatura ativa (Pioneer, Explorer, Adventurer ou Hero)
Uso por minuto: chamadas usadas, limite e restantes no minuto atual
Orçamento semanal: chamadas usadas, limite semanal, restantes e percentual usado
Timestamp do próximo reinício semanal (
resets_at— sempre uma sexta-feira às 00:00 UTC)
Uma resposta típica se parece com isto:
{
"tier": "explorer",
"minute": {
"used": 1,
"limit": 600,
"remaining": 599
},
"week": {
"used": 4215,
"limit": 30000,
"remaining": 25785,
"percent_used": 14,
"resets_at": "2026-05-29T00:00:00.000Z"
},
"historical_days": 365,
"allowed_exchanges": null
}Observe que há dois limites para observar, não um: um limite de taxa por minuto de curto prazo e um orçamento semanal de longo prazo. Fluxos de trabalho paralelos intensos tendem a atingir o limite por minuto; o uso diário sustentado tende a consumir o orçamento semanal.
Para monitoramento contínuo, adicione uma verificação de uso aos seus fluxos de trabalho agendados. No final de cada execução, inclua:
Após completar o acima, consulte o endpoint de uso do Cryptohopper MCP e anexe: "Quota usada: X / Y (Z% do limite semanal)" ao relatório.Dessa forma, cada relatório agendado carrega sua própria pegada de cota.
Se você estiver executando vários agentes em chaves diferentes, rastreie o uso por chave incluindo o identificador ou nome da chave nos logs. Observe que a cota é compartilhada entre todas as chaves da conta — consulte níveis de assinatura. A identificação por chave é para atribuição, não para orçamentos separados.
Configuração de alertas
Para alertas automatizados quando o uso se aproxima do limite, envolva a verificação de uso em um script agendado. O MCP já retorna percent_used, então você não precisa calculá-lo — mas pode derivá-lo de used e limit se preferir. Pseudocódigo:
usage = mcp_client.get_usage()
pct = usage["week"]["percent_used"] # fornecido diretamente pelo MCP
if pct > 80:
send_telegram(f"Aviso: uso do MCP em {pct:.0f}% do limite semanal")
if pct > 95:
send_telegram(f"CRÍTICO: uso do MCP em {pct:.0f}% — fluxos de trabalho podem falhar")
Execute isso a cada hora ou diariamente, dependendo de quão intensos são seus fluxos de trabalho. Veja como agendar fluxos de trabalho do Cryptohopper MCP para o lado de agendamento e como enviar relatórios do MCP para Telegram, Discord ou e-mail para entrega.
Reduzindo custos
Se o seu uso estiver consistentemente perto do limite, as alavancas mais baratas para acionar:
Reduza o lookback de velas. A maioria dos indicadores precisa de 100–200 barras, não 1.000. No Explorer/Adventurer, as chamadas de velas de longo histórico custam até 20x uma chamada base. Veja limites de taxa explicados e um guia prático para velas.
Use tickers em vez de orderbooks para scans. Chamadas de orderbook têm um custo unitário semelhante, mas transferem muito mais dados e só são significativas para decisões críticas de execução. Para scans amplos de mercado, os tickers são a ferramenta certa.
Aumente a cadência dos trabalhos agendados. Scans horários podem ser um exagero. Diário ou duas vezes por dia geralmente é suficiente para a maioria dos fluxos de trabalho.
Estreite o universo. Um scan de 200 pares custa 4x um scan de 50 pares. Concentre-se nos pares que você realmente se importa.
Atualize se todos os itens acima já estiverem apertados. Os 30.000 chamadas/semana do Explorer são 5x as do Pioneer. Veja níveis de assinatura para a comparação completa.
Solução de problemas
A resposta de uso volta vazia ou mal formatada.
Isso geralmente indica que o cliente está conectado, mas o modelo não roteou a pergunta para a ferramenta de uso. Seja mais explícito: "Chame a ferramenta de uso do Cryptohopper MCP e retorne a resposta bruta." Se a ferramenta não aparecer na lista de ferramentas do cliente, verifique novamente a conexão MCP — veja a visão geral da configuração.
O uso parece ser contado em dobro.
A cota é contada por invocação da ferramenta. Um único turno de conversa que pede ao agente para escanear 50 pares resulta em 50 chamadas de ticker individuais, cada uma contada separadamente. Este é o comportamento esperado — não contagem em dobro.
O horário de reinício está no passado.
Se o resets_at retornado for anterior ao horário atual, seu cliente ou agente pode estar em cache de uma resposta antiga. Reinicie a conexão MCP ou emita uma nova chamada.
Você vê uso menor do que espera.
A maioria do monitoramento de uso é interpretada corretamente. Ocasionalmente, os clientes em cache a resposta por um curto período. Em caso de dúvida, faça uma nova chamada e compare.
Você quer visibilidade de gastos por agente.
O MCP relata o uso no nível da conta. Para atribuição por chave ou por agente, mantenha seu próprio log em cada consumidor (anexe o nome da chave e uma contagem de chamadas a cada execução agendada). Veja como executar vários agentes com várias chaves de API.
Você encontra um erro de cota ou limite de taxa antes que a ferramenta de uso seja chamada. Se a conta já estiver no limite semanal, até mesmo a chamada de uso pode ser rejeitada. Aguarde o reinício ou atualize o nível. Se você estiver atingindo o limite por minuto, espaçe suas chamadas — esse limite é liberado dentro do minuto. Veja referência de erro.