DATA FOR YOUR TOOLS
HOSTuvo Data API v1 : intégrer les données avec leur contexte
Créez vos vues à partir de résultats en lecture seule en conservant instrument, source, horizon et fraîcheur.
L’API expose certains résultats analytiques, pas l’exécution en bourse ni les détails privés des modèles. Un succès HTTP confirme la requête ; il ne rend pas chaque métrique actuelle ou exécutable. Affichez explicitement valeurs absentes et observations retardées.
Authentification et accès
Envoyez la clé via Authorization: Bearer. La clé complète est affichée une fois à sa création ; les droits sont contrôlés côté serveur.
- Jusqu’à 3 clés actives.
- Préfixe hst_v1_.
- L’expiration PRO désactive l’accès.
Limites et codes d’erreur
Data API v1 autorise 60 requêtes par minute et 10 000 par jour. Limite, clé invalide et droits manquants sont des états distincts.
- 429 : limite dépassée.
- 401 : clé absente ou invalide.
- 403 : droit requis manquant.
Choisir les endpoints adaptés
Utilisez marchés, instantanés, historique et résultats selon le besoin. Conservez symbole et contexte renvoyés.
- /api/v1/markets
- /api/v1/opportunities/top10
- /api/v1/premove/INJUSDC
Un accès en lecture seule
L’API n’exécute pas d’ordres et ne fournit pas les poids privés des modèles. Un résultat analytique reste un résultat dans votre dashboard.
- Aucun endpoint BUY/SELL/ORDER.
- Aucune clé de trading d’exchange requise.
- Ordres automatiques en argent réel désactivés.
Construire une boucle d’interrogation robuste
Interrogez seulement les endpoints nécessaires et réutilisez les réponses entre composants. Ne répétez pas toute une rafale immédiatement après une erreur. Pour les limites, respectez l’instruction de nouvelle tentative du serveur ; sinon augmentez les délais de manière bornée. Expliquez les erreurs d’authentification ou de droits au lieu de répéter une requête invalide. Un champ absent reste indisponible, pas égal à zéro.
- Définir délai maximal et annulation.
- Éviter les doublons après reconnexion.
- Afficher l’heure d’observation à côté du cache.
Conserver le sens analytique lors de l’export
Gardez symbole, plateforme de référence ou d’exécution, horizon, heure et statut diagnostique avec chaque ligne PRE-MOVE. Une place Top 10 est un classement dans un scan, pas une probabilité ni un ordre. Si un tableur joint des instantanés de moments différents, signalez ce décalage. Comparez la même définition de prévision dans vos propres synthèses.
- Transmettre la provenance au CSV et à la base.
- Distinguer null, zéro et indisponible.
- Séparer résultats simulés et exécutés.
Garder les clés hors des pages publiques
Générez une clé dans l’interface autorisée et stockez-la hors du code public, des captures et des tableurs partagés. Passez par votre propre serveur si un dashboard public exige un secret. Révoquez les clés inutilisées et mettez délibérément à jour le service consommateur. Traitez la perte de droits comme un état d’accès sans remplacer une réponse PRO par des données inventées.
- Ne jamais envoyer la clé complète au support.
- Utiliser les endpoints documentés en lecture seule.
- Tester les erreurs sans transaction financière.
curl https://app.hostuvo.com/api/v1/opportunities/top10 \
-H "Authorization: Bearer hst_v1_YOUR_KEY"Créez une clé dans votre compte. Le secret complet est affiché une fois ; conservez-le sur votre serveur.
Poursuivre la lecture