Referência de erros

Esta página lista os erros retornados pelo Cryptohopper Market Data MCP e descreve a causa e o tratamento recomendado para cada um.

Para um guia de solução de problemas orientado a tarefas, consulte solução de problemas comuns do MCP.

Formato de erro

Os erros são retornados ao cliente MCP no envelope de erro padrão do MCP. Os campos:

Campo	Tipo	Descrição
code	string	Um identificador estável em maiúsculas (ex: QUOTA_EXCEEDED).
message	string	Uma descrição legível.
details	object	Contexto estruturado opcional.

O code é o contrato estável. Os clientes devem ramificar com base no code, não no texto de message.

Erros de autenticação

UNAUTHORIZED

A chave de API está ausente, malformada, expirada ou revogada.

Causas comuns:

• Nenhum cabeçalho Authorization na solicitação.
• Token bearer malformado (espaços em branco, artefatos de copiar e colar).
• A chave foi revogada na interface da conta Cryptohopper.
• A chave foi gerada para um produto diferente e não é válida para o MCP.

Tratamento: regenere a chave na interface da conta Cryptohopper e reconfigure o cliente. Consulte práticas recomendadas de segurança de chave de API e como obter uma chave de API do Cryptohopper MCP.

FORBIDDEN

A solicitação está autenticada, mas a conta não tem permissão para executar a ação solicitada.

Causas comuns:

• A conta está suspensa ou sinalizada.
• O endpoint foi restrito para a conta.

Tratamento: entre em contato com o suporte da Cryptohopper. Regenerar a chave não resolverá este erro.

Erros de cota e limite de taxa

QUOTA_EXCEEDED

A conta atingiu seu limite semanal de chamadas.

Tratamento: aguarde a próxima redefinição (sexta-feira), faça upgrade do nível de assinatura ou audite os padrões de chamada para reduzir o uso. O campo details.reset_at contém o timestamp da próxima redefinição.

Consulte limites de taxa explicados e níveis de assinatura.

RATE_LIMIT_EXCEEDED

A conta excedeu o limite de taxa de intervalo curto.

Tratamento: tente novamente após uma breve pausa. Clientes bem comportados recuam exponencialmente; uma nova tentativa inicial após 500ms é normalmente suficiente. Se o erro se repetir, adicione uma pequena pausa entre chamadas sequenciais no seu fluxo de trabalho.

HISTORY_LIMIT_EXCEEDED

Uma solicitação de velas especificou um período retroativo maior do que o histórico máximo do nível ativo.

Tratamento: reduza o período retroativo ou faça upgrade para um nível com histórico mais profundo. Consulte níveis de assinatura.

Erros de nível e acesso

EXCHANGE_NOT_SUPPORTED

A corretora solicitada não está disponível para o nível ativo ou não é suportada pelo MCP.

Tratamento: confirme que a corretora está na lista de permissões do nível em corretoras suportadas. Se a corretora estiver listada para um nível superior, faça upgrade. Se não estiver listada, a corretora não é suportada.

PAIR_NOT_FOUND

O par de moedas solicitado não existe na corretora especificada ou o símbolo do par está malformado.

Tratamento: verifique o símbolo do par usando a ferramenta list-pairs. Os símbolos de par usam o formato BASE/QUOTE (ex: BTC/USDT).

TIMEFRAME_NOT_SUPPORTED

O período (intervalo) de velas solicitado não é suportado para esta corretora ou par de moedas.

Tratamento: use um período suportado. Consulte referência da ferramenta de velas.

Erros de solicitação

INVALID_PARAMETER

Um ou mais argumentos da ferramenta falharam na validação.

Causas comuns:

• Período retroativo menor que 1 ou acima do máximo do nível.
• Valores não-string onde strings são necessárias.
• Identificadores de corretora ou par malformados.

Tratamento: o objeto details contém o parâmetro problemático. Corrija e tente novamente.

MISSING_PARAMETER

Um argumento obrigatório não foi fornecido.

Tratamento: o objeto details nomeia o parâmetro ausente. Corrija e tente novamente.

Erros upstream

EXCHANGE_UNAVAILABLE

A API da corretora subjacente não está respondendo ou está retornando erros. Isso é normalmente transitório.

Tratamento: tente novamente após uma breve pausa. Se o erro persistir em várias corretoras, pode indicar um incidente do lado do MCP — verifique a página de status da Cryptohopper.

DATA_UNAVAILABLE

Os dados solicitados existem conceitualmente, mas estão temporariamente indisponíveis (por exemplo, uma série de velas que ainda não foi populada).

Tratamento: tente novamente após uma pausa. Para interrupções prolongadas, escolha uma corretora diferente ou um par de moedas diferente.

Erros de servidor

INTERNAL_ERROR

Ocorreu um erro inesperado dentro do servidor MCP.

Tratamento: tente novamente uma vez. Se o erro persistir, relate-o através do suporte da Cryptohopper com o details.trace_id, se presente.

SERVICE_UNAVAILABLE

O serviço MCP está temporariamente incapaz de processar solicitações. Geralmente durante manutenção ou sob carga incomum.

Tratamento: tente novamente após uma pausa. Verifique a página de status da Cryptohopper para incidentes em andamento.

Tabela de referência rápida

Code	Categoria	Tentar novamente?	Solução
UNAUTHORIZED	Autenticação	Não	Regenerar chave
FORBIDDEN	Autenticação	Não	Contatar suporte
QUOTA_EXCEEDED	Cota	Na redefinição	Fazer upgrade do nível ou reduzir uso
RATE_LIMIT_EXCEEDED	Cota	Após pausa	Limitar cliente
HISTORY_LIMIT_EXCEEDED	Nível	Não	Reduzir período retroativo / fazer upgrade do nível
EXCHANGE_NOT_SUPPORTED	Nível	Não	Verificar lista de permissões do nível
PAIR_NOT_FOUND	Solicitação	Não	Verificar símbolo do par
TIMEFRAME_NOT_SUPPORTED	Solicitação	Não	Usar período suportado
INVALID_PARAMETER	Solicitação	Não	Corrigir parâmetro
MISSING_PARAMETER	Solicitação	Não	Adicionar parâmetro
EXCHANGE_UNAVAILABLE	Upstream	Sim	Nova tentativa breve
DATA_UNAVAILABLE	Upstream	Sim	Pausar e tentar novamente
INTERNAL_ERROR	Servidor	Uma vez	Relatar se persistir
SERVICE_UNAVAILABLE	Servidor	Sim	Pausar e tentar novamente