DATA FOR YOUR TOOLS
HOSTuvo Data API v1: integre os dados com o contexto
Crie vistas com resultados só de leitura preservando instrumento, fonte, horizonte e atualidade.
A API disponibiliza resultados analíticos selecionados, não execução em bolsa nem detalhes privados dos modelos. Sucesso HTTP confirma o pedido; não torna cada métrica atual ou executável. Mostre explicitamente valores ausentes e observações atrasadas.
Autenticação e acesso
Envie a chave como Authorization: Bearer. A chave completa é mostrada uma vez ao criar; o servidor verifica as permissões.
- Até 3 chaves ativas.
- Prefixo hst_v1_.
- A expiração PRO desativa o acesso.
Limites e códigos de erro
Data API v1 permite 60 pedidos por minuto e 10 000 por dia. Limite, chave inválida e falta de permissão são estados diferentes.
- 429: limite ultrapassado.
- 401: chave ausente ou inválida.
- 403: falta a permissão necessária.
Escolha os endpoints adequados
Use mercados, snapshots, histórico e resultados conforme a necessidade. Preserve símbolo e contexto devolvidos.
- /api/v1/markets
- /api/v1/opportunities/top10
- /api/v1/premove/INJUSDC
Acesso só de leitura
A API não executa ordens nem fornece pesos privados dos modelos. Um resultado analítico continua a ser um resultado no seu dashboard.
- Sem endpoints BUY/SELL/ORDER.
- Sem chaves de trading de exchanges.
- Ordens automáticas com dinheiro real desativadas.
Crie um ciclo de consultas resistente
Consulte apenas os endpoints necessários e reutilize respostas entre componentes. Não repita uma série inteira imediatamente após falhar. Perante limites, respeite a instrução de repetição do servidor; caso contrário, aumente os intervalos de forma limitada. Explique erros de autenticação ou permissões em vez de repetir pedidos inválidos. Um campo ausente continua indisponível, não se torna zero.
- Defina timeout e cancelamento.
- Evite duplicados após reconexão.
- Mostre a hora da observação junto à cache.
Preserve o significado ao exportar
Guarde símbolo, plataforma de referência ou execução, horizonte, hora e estado de diagnóstico em cada linha PRE-MOVE. Uma posição Top 10 é um ranking num scan, não uma probabilidade nem uma ordem. Se uma folha juntar snapshots de horas diferentes, mostre essa diferença. Compare a mesma definição de previsão ao calcular resumos próprios.
- Inclua proveniência no CSV e na base de dados.
- Distinga null, zero e indisponível.
- Separe resultados simulados e executados.
Mantenha as chaves fora de páginas públicas
Gere a chave no painel autorizado e guarde-a fora de código público, capturas e folhas partilhadas. Use o seu servidor quando um dashboard público precisar de um segredo. Revogue chaves sem uso e atualize deliberadamente o serviço consumidor. Trate a perda de permissões como estado de acesso, sem substituir respostas PRO por dados inventados.
- Nunca envie a chave completa ao suporte.
- Use endpoints documentados só de leitura.
- Teste erros sem transações financeiras.
curl https://app.hostuvo.com/api/v1/opportunities/top10 \
-H "Authorization: Bearer hst_v1_YOUR_KEY"Crie uma chave no painel da conta. O segredo completo aparece uma vez; guarde-o no seu servidor.
Continue a aprender