L’API Hyperliquid : guide 2026 pour les bots et les traders quant

L’API Hyperliquid est l’interface publique et programmatique de la plateforme de perpétuels Hyperliquid. Comme Hyperliquid est une DEX entièrement on-chain, tout ce que vous pouvez faire via l’écran de trading — lire les prix, passer des ordres, gérer des positions — vous pouvez aussi le faire depuis du code en signant et en envoyant des requêtes. Cela fait des bots, des stratégies quant et des dashboards sur mesure un cas d’usage de premier ordre plutôt qu’un détour (Hyperliquid Docs — API (Info, Exchange & WebSocket)).

L’API est du simple JSON sur HTTP pour les requêtes, avec un WebSocket séparé pour le streaming, ce qui la rend accessible depuis n’importe quel langage. Pour les développeurs Python, il existe un SDK officiel qui encapsule l’ensemble. Ce guide parcourt les trois surfaces, le fonctionnement de l’authentification via les agent wallets, le SDK et les rate limits, ainsi que la façon de démarrer.

L’API est organisée en trois surfaces, chacune avec un rôle clair (Hyperliquid Docs — API (Info, Exchange & WebSocket)) :

• Endpoint Info (lecture). Renvoie les métadonnées de marché, les carnets d’ordres, les chandeliers, le funding, vos positions ouvertes, vos soldes et l’historique des exécutions. La plupart des requêtes Info ne nécessitent aucune signature — c’est ainsi qu’un bot observe le monde avant de décider quoi que ce soit.
• Endpoint Exchange (trade). Là où l’état change : passer, modifier et annuler des ordres, régler le leverage et le mode de marge, et déplacer des fonds au sein de votre propre compte. Chaque requête Exchange doit être signée cryptographiquement par votre wallet ou par un agent wallet autorisé.
• WebSocket (temps réel). Abonnez-vous aux flux en direct de prix, de carnet d’ordres, de trades et de mises à jour de compte pour qu’un bot réagisse instantanément au lieu de sonder. Pour tout ce qui est sensible à la latence, le WebSocket est la surface autour de laquelle vous construisez.

Une boucle typique ressemble à ceci : lire l’état depuis Info (ou un abonnement WebSocket), appliquer la logique de votre stratégie, puis agir via l’endpoint Exchange. Ce cycle Info-décision-Exchange est la colonne vertébrale de presque tous les bots de trading Hyperliquid.

L’élément qui rend le trading par API sur Hyperliquid véritablement sûr est l’agent wallet (aussi appelé API wallet). Plutôt que de confier à votre bot votre clé privée principale, vous autorisez une clé distincte qui peut passer et annuler des ordres mais ne peut pas retirer ni transférer vos fonds (Hyperliquid Docs — API (Info, Exchange & WebSocket)).

• Cela reste non-custodial. Vos USDC et vos positions restent dans votre propre compte Hyperliquid. La clé de l’agent signe les actions de trading qui les concernent ; elle ne les détient jamais.
• La compromission est contenue. Une clé d’agent divulguée permet à un attaquant de trader sur votre compte mais pas de le vider — un rayon d’impact bien plus réduit qu’une clé API d’une plateforme centralisée divulguée avec droits de retrait.
• Il y a des limites au nombre que vous pouvez détenir. Un compte peut approuver un nombre limité d’agent wallets, et les approbations peuvent expirer — confirmez les chiffres actuels dans la documentation (Hyperliquid Docs — Rate limits and user limits).

Le moyen le plus rapide de démarrer est le SDK Python open-source officiel d’Hyperliquid, qui encapsule les surfaces Info, Exchange et WebSocket, gère la signature des requêtes et fournit des scripts d’exemple pour des tâches courantes comme passer un ordre ou s’abonner à un flux (Hyperliquid — official Python SDK (GitHub)). C’est une couche de confort — sous le capot, c’est la même API JSON/HTTP que vous pourriez appeler depuis JavaScript, Rust ou Go.

Les bots en production doivent respecter les rate limits. Hyperliquid documente à la fois des limites de requêtes par IP et des limites par adresse qui évoluent avec votre activité de trading, ainsi que des coûts pondérés qui font « coûter » davantage les requêtes plus lourdes (Hyperliquid Docs — Rate limits and user limits). Les implications pratiques :

• Préférez le WebSocket au polling.S’abonner à un flux est bien moins coûteux que de marteler l’endpoint Info en boucle.
• Regroupez et temporisez. Groupez les requêtes là où l’API l’autorise, et ajoutez un backoff exponentiel pour qu’un pic ne vous fasse pas throttler.
• Vérifiez les chiffres exacts. Les limites évoluent dans le temps, alors relevez-les sur la page officielle des rate limits au moment du développement plutôt que de vous fier à un blog secondaire (Hyperliquid Docs — Rate limits and user limits).

Un premier parcours réaliste, de zéro à un bot auto-custodial en production :

1. Approvisionnez un compte Hyperliquid. Il vous faut des USDC on-chain dans votre propre wallet sur la plateforme — c’est le compte que l’API lira et tradera.
2. Approuvez un agent wallet. Générez et autorisez une clé API/agent pour que votre code puisse signer des requêtes Exchange sans jamais détenir de droits de retrait.
3. Lisez avec Info / WebSocket. Commencez par récupérer les données de marché et vos positions — sans argent en jeu — jusqu’à ce que le flux de données soit solide.
4. Passez des ordres de test via Exchange.Utilisez de petites tailles (ou des ordres post-only / des ordres limites loin du mid) pour confirmer que la signature, les exécutions et les annulations fonctionnent comme prévu.
5. Ajoutez des contrôles de risque avant de passer à l’échelle. Plafonds de position, leverage maximal, kill-switches et limites de drawdown doivent figurer dans le code dès le premier jour, pas après la première mauvaise journée.

À partir de là, la stratégie est la partie difficile — pas la tuyauterie. Voir le trading algorithmique en crypto pour les familles de stratégies (market making, arbitrage, grid, tendance, retour à la moyenne) et le trading quant en crypto pour le flux de la recherche à la production qui transforme une idée en quelque chose qui vaut la peine d’être exécuté. Pour un panorama complet des bots, voir les bots de trading crypto.

L’API Hyperliquid offre aux développeurs une surface de trading complète et non-custodial : un endpoint Info pour lire, un endpoint Exchange pour trader, un WebSocket pour les données en temps réel, des agent wallets qui tradent mais ne retirent jamais, un SDK Python officiel, et des rate limits documentés. C’est cette combinaison qui rend les bots auto-custodiaux et les stratégies quant praticables sur Hyperliquid.

Contenu éducatif uniquement — pas un conseil en investissement. Le trading automatisé comporte un risque et les bots peuvent perdre de l’argent ; les performances passées ou backtestées ne préjugent pas des résultats futurs. Les endpoints de l’API, les rate limits, les limites d’agent wallets et les prérequis du SDK changent — vérifiez tout dans la documentation officielle d’Hyperliquid avant de construire ou de trader. Facts verified 2026-06-30.