Conta, chaves e visão geral de uso
Esta página descreve como uma conta Cryptohopper, suas chaves de API e seu uso de MCP se relacionam. É o mapa conceitual que conecta planos de assinatura, segurança de chaves de API e limites de taxa.
Modelo de conta
Uma conta Cryptohopper é a autoridade raiz para tudo descrito nesta documentação. A conta mantém:
- O plano de assinatura ativo (Pioneer, Explorer, Adventurer, Hero).
- O conjunto de chaves de API (com limites por plano sobre quantas podem existir simultaneamente).
- O contador de uso semanal atual e o horário de reinicialização.
- A lista de corretoras que a conta tem permissão para consultar.
Todas as solicitações MCP autenticam com base em uma chave de API, que por sua vez resolve para uma conta. Todos os limites descritos nesta documentação são aplicados por conta.
Chaves de API
Uma chave de API é um token de portador emitido pela conta. É apresentada no cabeçalho Authorization de cada solicitação MCP:
Authorization: Bearer
Propriedades da chave
| Propriedade | Descrição |
|---|---|
| Propriedade | As chaves estão vinculadas à conta que as criou. |
| Escopo | Todas as chaves sob uma conta compartilham acesso idêntico — mesmo plano, mesmas corretoras, mesma cota. |
| Revogação | As chaves podem ser revogadas a qualquer momento através da interface da conta Cryptohopper. A revogação entra em vigor imediatamente. |
| Rotação | Uma nova chave pode ser criada e uma chave antiga revogada de forma independente. |
| Cota | As chaves compartilham a cota semanal única da conta. Criar chaves adicionais não aumenta a cota. |
Quando usar múltiplas chaves
O número de chaves que uma conta pode ter depende do plano (veja planos de assinatura). Múltiplas chaves são úteis para:
- Separação por agente. Diferentes agentes de IA ou fluxos de trabalho recebem cada um sua própria chave. Ao rotacionar ou revogar uma chave, apenas o agente proprietário é afetado.
- Separação por ambiente. Uma chave de produção e uma chave de desenvolvimento, cada uma revogável independentemente.
- Atribuição. Logs de uso (quando disponíveis) podem ser inspecionados por chave para identificar qual consumidor está gastando a cota.
Múltiplas chaves não afetam a cota. Todas as chaves compartilham o mesmo limite semanal no nível da conta. Veja como executar múltiplos agentes com múltiplas chaves de API.
Uso
O uso é rastreado por conta, em unidades de chamada. O contador semanal é incrementado toda vez que uma ferramenta é invocada. Veja limites de taxa explicados para entender como chamadas se traduzem em unidades.
O MCP expõe uma ferramenta de inspeção que retorna o estado atual de uso:
| Campo | Tipo | Descrição |
|---|---|---|
| tier | string | O plano de assinatura ativo. |
| calls_used | integer | Unidades usadas no ciclo semanal atual. |
| calls_limit | integer | O limite semanal do plano. |
| reset_at | string (ISO-8601) | Timestamp da próxima reinicialização semanal. |
Veja uso e limites para o esquema de resposta completo e exemplos de invocações.
Reinicialização semanal
Todas as contas compartilham a mesma cadência de reinicialização: o contador semanal é reiniciado toda sexta-feira. O horário exato de reinicialização por conta é estável entre as semanas e é retornado no campo reset_at.
Erros relacionados a uso (QUOTA_EXCEEDED) são resolvidos automaticamente na reinicialização.
Plano e cobertura de corretoras
O plano da conta determina:
- Quais corretoras podem ser consultadas através do MCP.
- Quanto dado histórico de velas pode ser solicitado.
- Quantas chaves de API podem existir simultaneamente.
- O limite semanal de chamadas e o fator de custo para dados históricos.
Veja planos de assinatura para a matriz completa e corretoras suportadas para a lista de corretoras.
Falha de autenticação
Uma chave de API inválida, revogada ou malformada retorna uma resposta 401 Unauthorized, mapeada para um erro UNAUTHORIZED no esquema de erro do MCP. Veja referência de erros.
Considerações de segurança
As chaves de API concedem acesso de leitura a dados de mercado sob o plano da conta. Elas não concedem acesso a bots Cryptohopper, credenciais de API de corretoras ou à própria conta. No entanto, chaves comprometidas consomem cota e podem contribuir para ruído de limite de taxa.
Veja práticas recomendadas de segurança de chaves de API para orientação sobre:
- Armazenamento e gerenciamento de segredos.
- Cadência de rotação de chaves.
- Revogação de chaves comprometidas.
- Separação de chaves por ambiente.
Relação com a API de Trading Cryptohopper
O MCP Cryptohopper e a API REST de Trading Cryptohopper usam tokens de autenticação separados emitidos sob a mesma conta. Uma chave MCP não autoriza chamadas da API de Trading, e vice-versa.
Para agentes completos que usam o MCP para pesquisa e a API de Trading para execução, ambas as credenciais são necessárias. Veja Combine MCP + API de Trading Cryptohopper para agentes completos.
Verificando o estado da conta de um cliente MCP As consultas comuns feitas a partir de um cliente compatível com MCP:
Qual é o meu plano MCP Cryptohopper atual? Quanto da minha cota semanal eu usei? Quais corretoras tenho permissão para consultar?
Cada uma dessas direciona para a ferramenta correspondente e retorna uma resposta estruturada que o modelo resume.