Níveis de assinatura
Esta página documenta os níveis de assinatura disponíveis para o Cryptohopper Market Data MCP.
Resumo dos níveis
| Pioneer | Explorer | Adventurer | Hero | |
|---|---|---|---|---|
| Custo | Gratuito | Pago | Pago | Pago |
| Limite semanal de chamadas | 6.000 | 30.000 | 150.000 | 1.250.000 |
| Corretoras | 3 | 8 | Todas as suportadas | Todas as suportadas |
| Dados históricos | Nenhum | Até 90 dias | Até 365 dias | Até 3 anos |
| Fator de custo histórico | — | 5× / 20× | 5× / 20× | 1× (fixo) |
| Chaves de API permitidas | 1 | 1 | 3 | 10 |
Todos os limites são renovados toda sexta-feira. O limite semanal de chamadas e o limite de taxa se aplicam por conta de usuário, não por chave de API.
Para obter os preços atuais dos níveis pagos, consulte a página de preços do Cryptohopper.
Limite semanal de chamadas
Cada nível tem um número fixo de chamadas que podem ser feitas por semana. As chamadas são contadas por invocação de ferramenta. Uma única invocação de ferramenta conta como uma unidade base, sujeita ao fator de custo histórico descrito abaixo.
O contador semanal é redefinido toda sexta-feira. O horário exato da redefinição é registrado na conta do usuário e fica visível através do endpoint de uso. Consulte uso e limites.
Solicitações feitas após o limite semanal ser atingido retornam um erro QUOTA_EXCEEDED até a próxima redefinição. Consulte a referência de erros.
Acesso a corretoras
O acesso a corretoras é restrito por nível. O nível Pioneer está limitado a três corretoras; o Explorer estende isso para oito; os níveis Adventurer e Hero expõem a lista completa.
Consulte as corretoras suportadas para ver a matriz completa.
Solicitações direcionadas a uma corretora fora da lista permitida do nível atual retornam um erro EXCHANGE_NOT_SUPPORTED.
Dados históricos
Dados históricos referem-se a consultas de velas com um período de retrospectiva maior que a barra mais recente.
| Nível | Disponibilidade histórica |
|---|---|
| Pioneer | Não disponível. Apenas a vela atual (tempo real) é retornada. |
| Explorer | Até 90 dias de histórico. |
| Adventurer | Até 365 dias de histórico. |
| Hero | Até 3 anos de histórico. |
Solicitações que excedem o limite histórico do nível atual retornam um erro HISTORY_LIMIT_EXCEEDED.
Consultas de ticker e livro de ofertas são sempre em tempo real e não estão sujeitas ao limite histórico.
Fator de custo para dados históricos
Nos níveis Explorer e Adventurer, consultas de velas históricas são cobradas com um multiplicador em relação à unidade base por chamada:
| Profundidade de retrospectiva | Multiplicador de custo |
|---|---|
| Histórico curto (recente) | 5× |
| Histórico longo (próximo ao limite do nível) | 20× |
No nível Hero, todas as consultas históricas são cobradas a 1× independentemente da profundidade de retrospectiva.
Consultas de ticker e livro de ofertas são sempre cobradas a 1× em todos os níveis.
Os limites exatos entre histórico "curto" e "longo", e a matriz completa de custos, estão documentados em limites de taxa explicados.
Chaves de API
Cada nível permite um número máximo de chaves de API ativas simultaneamente:
| Nível | Máximo de chaves |
|---|---|
| Pioneer | 1 |
| Explorer | 1 |
| Adventurer | 3 |
| Hero | 10 |
As chaves de API são geradas e revogadas através da interface da conta Cryptohopper.
Cota por conta. Criar chaves adicionais não aumenta o limite semanal de chamadas. Todas as chaves associadas a uma conta compartilham a mesma cota semanal e limite de taxa. As chaves são usadas para segmentação e rotação, não para multiplicação de cota. Consulte como executar múltiplos agentes com múltiplas chaves de API.
Consulte as práticas recomendadas de segurança para chaves de API.
Limites de taxa
Os limites de taxa se aplicam no nível da conta e são uniformes em todos os níveis. Os detalhes estão documentados em limites de taxa explicados.
Upgrade e downgrade
Mudanças de nível entram em vigor no início do próximo ciclo semanal. Fazer downgrade para um nível com menor limite de chaves de API pode exigir a revogação de chaves para se ajustar ao novo limite.
Verificando o nível ativo
O nível atual é retornado pelo endpoint de uso como um campo tier. Consulte uso e limites.
Exemplo de consulta através de um cliente MCP:
Qual é o meu nível atual do Cryptohopper MCP e quanto da minha cota semanal eu já utilizei?