DATA FOR YOUR TOOLS

HOSTuvo Data API v1: integra los datos con su contexto

Crea vistas con resultados de solo lectura conservando instrumento, fuente, horizonte y actualidad.

HOSTuvo Data API v1: integra los datos con su contexto

La API entrega resultados analíticos seleccionados, no ejecución bursátil ni detalles privados de modelos. Un éxito HTTP confirma la petición; no convierte cada métrica incluida en actual o ejecutable. Muestra explícitamente valores ausentes y observaciones retrasadas.

01

Autenticación y acceso

Envía la clave como Authorization: Bearer. La clave completa aparece una vez al crearla; el acceso depende de permisos comprobados por el servidor.

  • Hasta 3 claves activas.
  • Prefijo hst_v1_.
  • La caducidad de PRO desactiva el acceso.
02

Límites y códigos de error

Data API v1 permite 60 consultas por minuto y 10.000 al día. Límite, clave inválida y falta de permiso son estados diferentes.

  • 429: límite superado.
  • 401: clave ausente o inválida.
  • 403: falta el permiso requerido.
03

Selecciona los endpoints adecuados

Usa mercados, instantáneas, histórico y resultados según tu necesidad. Conserva símbolo y contexto del mercado devueltos.

  • /api/v1/markets
  • /api/v1/opportunities/top10
  • /api/v1/premove/INJUSDC
04

Acceso de solo lectura

La API no ejecuta órdenes ni entrega pesos privados de modelos. Un resultado analítico sigue siendo un resultado dentro de tu dashboard.

  • Sin endpoints BUY/SELL/ORDER.
  • Sin claves de trading de exchanges.
  • Órdenes automáticas con dinero real desactivadas.
05

Crea un ciclo de consultas resistente

Consulta solo los endpoints necesarios y reutiliza respuestas entre componentes. No repitas una ráfaga completa inmediatamente tras fallar. Ante límites, respeta la instrucción de reintento del servidor; si no existe, usa esperas crecientes acotadas. Explica errores de autenticación o permisos en vez de repetir una petición inválida. Un campo ausente permanece no disponible, no se convierte en cero.

  • Configura timeout y cancelación.
  • Evita duplicados tras reconectar.
  • Muestra la hora de observación junto a la caché.
06

Conserva el significado al exportar

Mantén símbolo, plataforma de referencia o ejecución, horizonte, hora y estado diagnóstico en cada fila PRE-MOVE. Una posición Top 10 es un ranking dentro de un escaneo, no una probabilidad ni una orden. Si una hoja combina instantáneas de horas diferentes, muestra esa diferencia. Compara la misma definición de pronóstico al calcular resúmenes propios.

  • Incluye procedencia en CSV y bases de datos.
  • Distingue null, cero y no disponible.
  • Separa resultados simulados y ejecutados.
07

Mantén las claves fuera de páginas públicas

Genera la clave desde el panel autorizado y guárdala fuera del código público, capturas y hojas compartidas. Usa tu propio servidor si un dashboard público necesita un secreto. Revoca claves sin uso y actualiza deliberadamente el servicio consumidor. Trata la pérdida de permisos como un estado de acceso, sin sustituir respuestas PRO por datos inventados.

  • Nunca envíes la clave completa al soporte.
  • Usa endpoints documentados de solo lectura.
  • Prueba errores sin transacciones financieras.
QUICK START
curl https://app.hostuvo.com/api/v1/opportunities/top10 \
  -H "Authorization: Bearer hst_v1_YOUR_KEY"

Crea una clave en el panel de cuenta. El secreto completo aparece una vez; guárdalo en tu servidor.