Un bot de trading de contrats perpétuels Hyperliquid gère l’exposition aux produits dérivés au moyen des ordres, des exécutions et des garanties. Acheter un contrat perpétuel ne signifie pas acquérir le jeton au comptant correspondant pour pouvoir le retirer. La valeur de la position évolue avec le contrat, et son fonctionnement exige de tenir compte de la marge, du financement et de la possibilité d’une liquidation. Ces caractéristiques rendent insuffisant, à lui seul, un processus de gestion des avoirs au comptant.
Une automatisation fiable commence par une description persistante de la modification de position prévue. Elle vérifie ensuite l’instrument et le compte, contrôle les ressources concernées, soumet une action encadrée et rapproche les données avec ce qui s’est réellement passé. La stratégie doit continuer à connaître ses obligations lorsqu’un ordre n’est exécuté qu’en partie, qu’une annulation entre en concurrence avec une transaction ou que le processus redémarre.
Cet article présente des informations générales sur les mécanismes des contrats perpétuels, sans affirmer qu’un logiciel particulier les prend en charge. Tous les exemples chiffrés sont hypothétiques et ne simplifient la complexité que lorsque cela est expressément indiqué. Aucun niveau de levier, taux de financement ou rendement attendu n’est recommandé.
Définir le cycle de vie des ordres du bot de trading de contrats perpétuels Hyperliquid
Le cycle de vie commence par une modification prévue de l’exposition signée : augmenter une position longue, réduire une position courte ou clôturer une quantité donnée, par exemple. L’intention doit préciser l’instrument, le compte, la taille maximale, la contrainte de prix et la version des règles. Une simple mention d’achat ne décrit pas entièrement l’objectif économique.
Conservez la distinction entre les états soumis, accepté, en attente dans le carnet, partiellement exécuté, entièrement exécuté et annulé. Les éléments précis fournis par l’API déterminent quels états s’appliquent. Une réponse positive au niveau du transport ne prouve pas, à elle seule, que toute la quantité prévue est devenue une position.
La présentation de l’exécution sur Hyperliquid explique l’importance de sélectionner le bon environnement et le bon compte. Pour les contrats perpétuels, reliez ce cadre à un registre des positions plutôt que de lui substituer un solde au comptant. Le registre doit conserver à la fois l’exposition actuelle et l’exposition supplémentaire que les ordres encore actifs pourraient créer.
Identifier précisément le contrat et le lieu de négociation
Le symbole d’un actif peut apparaître dans plusieurs produits ou contextes de marché. Le bot doit déterminer l’identifiant réel du contrat perpétuel, le lieu de négociation ou le déploiement concerné, l’actif de cotation ou de garantie, ainsi que la précision autorisée pour les tailles et les prix. Un symbole boursier familier ne suffit pas pour construire correctement un ordre.
La documentation actuelle d’Hyperliquid distingue les contrats perpétuels exploités par les validateurs et les marchés HIP-3, entre autres environnements de l’écosystème. Les paramètres des contrats et les relations de garantie disponibles doivent provenir des métadonnées du marché concerné. N’appliquez pas systématiquement un paramètre mémorisé pour un instrument à tous les contrats portant un nom similaire.
Conservez les métadonnées utilisées pour autoriser chaque action. Si la configuration d’un marché change, l’ancien enregistrement doit rester interprétable. Une consultation ultérieure peut expliquer le comportement actuel sans reproduire les conditions dans lesquelles un ordre antérieur a été préparé. Cette différence compte lors de l’examen d’un rejet ou d’une quantité inattendue.
Lire le mode de compte actif
La documentation actuelle accessible depuis le site officiel d’Hyperliquid décrit les configurations de compte standard, unifiée et à marge de portefeuille. Les relations entre leurs soldes et leurs garanties diffèrent. Un bot doit lire le mode actif plutôt que supposer que les ressources au comptant et celles des contrats perpétuels sont toujours séparées ou toujours partagées.
Dans les configurations unifiée et à marge de portefeuille, la vue des soldes et les réservations de fonds décrites dans la documentation peuvent couvrir des activités qu’un rapport limité au comptant ou à un seul DEX ne représenterait pas correctement. Une stratégie peut donc repérer une occasion locale attrayante alors que le compte, dans son ensemble, a déjà engagé les ressources nécessaires pour la saisir.
Considérez le mode de compte comme faisant partie du cadre de fonctionnement. Un changement de mode peut modifier l’interprétation des soldes et des limites, même lorsque la même stratégie reste active. Après un tel changement, effectuez un rapprochement du compte avant d’autoriser une nouvelle exposition sur la base d’hypothèses qui correspondaient à la configuration précédente.
Distinguer les limites de la stratégie de la marge exigée par la plateforme
L’acceptation d’un ordre par une plateforme d’échange ne prouve pas qu’il respecte les règles de risque de l’utilisateur. L’exigence de marge de la plateforme et l’exposition maximale autorisée par la stratégie répondent à des questions différentes. Une limite interne prudente peut rejeter un ordre alors que le compte dispose techniquement de garanties suffisantes pour le passer.
Dans un exemple fictif simplifié, trois unités d’un contrat perpétuel linéaire à 200 créent une exposition notionnelle de 600. Si l’exemple alloue une marge de 120, le rapport entre le notionnel et la marge correspond à un levier de cinq à l’entrée. Un mouvement défavorable du prix de dix pour cent entraîne une perte de soixante unités liée au prix, avant les frais et le financement, et consomme la moitié de cette marge illustrative.
Ce calcul n’est pas une formule de prix de liquidation. La liquidation réelle dépend de l’instrument, du mode de marge, de l’état du compte et des exigences de maintenance. L’exemple montre pourquoi une faible allocation de garanties ne rend pas la position économique petite. La taille de la position et la perte autorisée doivent avoir leurs propres limites explicites.
Choisir un comportement d’ordre adapté à l’intention
Une limite définit une borne de prix, tandis que la durée de validité de l’ordre détermine ce qu’il advient des quantités qui ne sont pas exécutées immédiatement. La documentation actuelle d’Hyperliquid sur les ordres distingue le maintien dans le carnet, l’exécution immédiate ou l’annulation du reliquat et le comportement post-only. L’adaptateur doit préserver la combinaison souhaitée par l’utilisateur plutôt que convertir chaque demande en un seul comportement par défaut.
Un ordre à exécution immédiate ou annulation du reliquat peut être partiellement exécuté, puis voir son reliquat annulé. Une instruction post-only vise à éviter de prendre immédiatement la liquidité disponible ; elle ne garantit pas qu’un ordre en attente dans le carnet sera ensuite exécuté ou rentable. Cette distinction compte pour estimer aussi bien l’exposition que les coûts d’exécution.
Le guide de gestion de l’API Hyperliquid explique pourquoi les résultats doivent être interprétés action par action. La stratégie doit réagir au résultat accepté pour l’ordre concerné. Elle ne doit pas déduire qu’une position complète existe du seul fait qu’une demande contenait la quantité souhaitée.
Préserver la précision décimale prévue lors de la construction
Les contraintes de prix et de taille doivent conserver la précision prévue, de la décision de la stratégie jusqu’à l’action signée. Un arrondi approximatif peut accroître l’exposition, déplacer une limite de l’autre côté de l’écart entre achat et vente ou produire une demande invalide. Le sens d’arrondi approprié dépend de la borne que représente la valeur.
Par exemple, un montant d’achat maximal autorisé ne doit pas être arrondi vers le haut simplement pour satisfaire une préférence d’affichage. Une instruction de clôture doit être vérifiée par rapport à la position actuelle et au pas de quantité autorisé. L’interface peut afficher un nombre plus court tandis que l’enregistrement persistant conserve la valeur exacte autorisée.
La validation doit avoir lieu avant la signature. Si une quantité ne peut pas être représentée selon les règles actuelles du marché, le système doit produire un rejet explicite ou un montant réduit faisant l’objet d’une justification distincte. Modifier silencieusement les valeurs après l’autorisation rend difficile la vérification de la conformité de l’action exécutée aux règles de l’utilisateur.
Distinguer le signataire du compte de trading
Un agent délégué peut signer des actions pour un compte sans être le compte dont il faut interroger les positions et les soldes. La documentation officielle sur les portefeuilles API souligne cette distinction. Interroger l’adresse de l’agent comme s’il s’agissait de celle du compte de trading peut produire un résultat vide et donner à tort l’impression qu’aucune exposition n’existe.
Stockez l’identité du signataire et celle du compte qui porte les engagements économiques dans des champs différents. L’enregistrement de l’ordre doit également identifier tout sous-compte concerné ou tout autre périmètre pris en charge. Cela évite de confondre la réussite d’un contrôle d’authentification avec la confirmation que la stratégie opère sur le portefeuille prévu.
Coordonnez les exigences de nonce du protocole par autorité de signature. Le modèle de nonce des actions signées d’HyperCore ne doit pas être remplacé par une séquence de transactions EVM supposée. Plusieurs processus partageant un signataire nécessitent une conception coordonnée, tandis qu’une autorité de signature distincte exige sa propre gestion des autorisations et du cycle de vie.
Considérer une soumission sans réponse comme non résolue
Une réponse perdue laisse subsister une incertitude sur l’action initiale. Elle ne prouve ni que l’action a échoué ni qu’un nouvel ordre peut être passé en toute sécurité. Conservez l’intention dans un enregistrement persistant et les identifiants d’ordre disponibles avant la soumission externe afin que la reprise puisse examiner la même demande économique.
Utilisez les éléments actuels du compte et des ordres pour déterminer si l’action a créé un ordre en attente dans le carnet, a été exécutée, a été rejetée ou reste indéterminée. Un identifiant d’ordre client peut aider à mettre les enregistrements en correspondance, mais il ne doit pas être présenté comme une garantie universelle que toute répétition d’une charge utile n’a aucun effet supplémentaire. Respectez le comportement documenté du point de terminaison concerné.
Tant que le résultat n’est pas résolu, maintenez la réservation appropriée de ressources et de capacité d’exposition. La libérer immédiatement peut permettre à un autre processus d’autoriser une seconde position. L’objectif de la reprise est d’établir ce que le compte pourrait déjà détenir, et pas simplement d’obtenir une réponse positive à une nouvelle demande.
Reconstituer l’exposition à partir des exécutions et des ordres restants
La quantité demandée, la quantité exécutée et le reliquat ouvert sont des valeurs distinctes. Si un ordre hypothétique demande cinq unités et en exécute deux, puis une demi-unité, la variation de position est de 2,5 et la quantité demandée restante est de 2,5 jusqu’à ce que l’état final de l’ordre soit établi.
L’examen du risque du compte doit inclure à la fois l’exposition actuelle de 2,5 unités et l’effet possible de ce reliquat. Une demande d’annulation peut viser à supprimer ce dernier, mais l’enregistrement ne doit pas l’effacer avant que l’état accepté de l’ordre confirme ce qui s’est passé.
Dédupliquez les données d’exécution lorsque les flux sont rejoués ou que les requêtes historiques se chevauchent. Compter deux fois la même exécution d’une demi-unité surestimerait la position et pourrait conduire à une action de clôture trop importante. Préservez un identifiant stable pour chaque exécution et rapprochez les totaux de la vue du compte faisant autorité, au lieu de supposer que chaque message reçu décrit une nouvelle transaction.
Recommandez et gagnez des USDC
Recommandez et gagnez des USDCNotre programme d’affiliation paie en temps réel.
Concevoir les sorties reduce-only du bot de trading de contrats perpétuels Hyperliquid
Les sorties reduce-only d’un bot de trading de contrats perpétuels Hyperliquid doivent exprimer l’intention de réduire une position existante sans ouvrir d’exposition dans le sens opposé. Les options d’ordre actuelles comprennent ce contrôle. Il est utile lorsqu’une autre action a pu modifier la position avant l’exécution de la sortie.
Supposons qu’un compte fictif détenait une position longue de trois unités lors de la préparation d’une sortie, mais qu’une autre vente autorisée l’a réduite à une unité. Une vente de trois unités sans contrainte pourrait clôturer le reliquat de la position longue et créer une position courte de deux unités. Une contrainte reduce-only correctement appliquée permet de prévenir cette inversion indésirable, sous réserve des règles réelles d’acceptation et d’exécution de la plateforme.
Le mode reduce-only ne garantit ni qu’une sortie aboutira ni qu’elle obtiendra un prix particulier. L’ordre peut toujours rencontrer une liquidité correspondante insuffisante, des paramètres invalides ou d’autres conditions de rejet. Le bot doit rapprocher les données de la position restante après la tentative plutôt que considérer la présence de cette option comme la preuve que le risque a disparu.
Distinguer le déclenchement d’une sortie de son exécution
Une condition de stop ou de prise de bénéfices peut activer un ordre sans mener une cession à son terme. La référence de déclenchement, la condition de prix, le type d’ordre qui en résulte et sa taille doivent être explicites. Les différents choix créent des compromis différents entre la maîtrise du prix et la probabilité d’exécution lorsque les conditions évoluent.
Un ordre à cours limité déclenché peut rester inexécuté si le marché sort de sa plage acceptable. Une sortie privilégiant une exécution au marché peut subir une exécution moins favorable que le niveau de déclenchement observé. Aucune des deux ne doit être présentée comme garantissant une perte maximale ou un bénéfice réalisé.
Suivez la position lors de l’activation et des exécutions suivantes. Si seule une partie est clôturée, la quantité restante doit toujours être gérée. Le contrôleur des sorties doit aussi tenir compte des interventions manuelles ou des actions d’une autre stratégie afin que les anciennes tailles de déclenchement ne deviennent pas silencieusement incompatibles avec l’état actuel du compte.
Gérer l’annulation comme une course avec le marché
Un ordre peut être exécuté pendant qu’une demande d’annulation est en transit. L’enregistrement final correct peut donc contenir une exécution partielle et un reliquat annulé. Ces résultats sont compatibles ; l’annulation ne supprime pas rétroactivement la transaction déjà effectuée.
Lors du remplacement d’un ordre, déterminez ce qu’il reste de l’ancienne instruction avant de décider de la taille du nouvel ordre. Une quantité souhaitée localement et le reliquat actuel sur la plateforme peuvent diverger pendant cet intervalle. Considérer le remplacement comme un ordre indépendant de taille complète peut créer une exposition excessive.
Le guide de reprise opérationnelle sur Hyperliquid explique pourquoi la responsabilité des obligations doit être clairement attribuée. Un composant doit décider comment articuler l’ancien ordre, les exécutions intervenues entre-temps et la modification proposée. Plusieurs processus tentant indépendamment de corriger la même annulation peuvent produire davantage d’incertitude que le retard initial.
Tenir une comptabilité distincte du financement du bot de trading de contrats perpétuels Hyperliquid
Le financement est une composante des flux de trésorerie de l’exposition aux contrats perpétuels, distincte du gain ou de la perte causés par les prix d’entrée et de sortie. La documentation actuelle sur le financement décrit des paiements entre détenteurs de positions longues et courtes et utilise un notionnel fondé sur le prix de l’oracle pour calculer ces paiements. Ne lui substituez pas un prix de marquage affiché sans vérifier la convention réellement appliquée.
Pour un intervalle fictif, deux unités à un prix d’oracle de 500 représentent un notionnel de financement de 1 000. Un taux de paiement supposé de 0,01 % produit un paiement de 0,1. Six intervalles identiques totaliseraient 0,6, mais les taux, les prix et les tailles de position réels peuvent changer entre les observations.
Le taux de l’exemple est inventé et ne prédit pas le sens d’un paiement. Enregistrez les crédits et débits réels à partir des données du compte, en les reliant à la période et à la position concernées. Une prévision de financement peut éclairer une décision, mais elle ne correspond pas à un financement déjà perçu ou payé.
Rapprocher les résultats liés aux prix, les frais et le financement
Gardez les composantes distinctes avant de calculer le résultat net. Dans une position longue hypothétique simplifiée, deux unités achetées à 500 et revendues à 520 produisent un gain brut de quarante lié au prix. Si les frais de trading enregistrés totalisent trois et que le financement net est un débit de 1,2, le résultat est de 35,8 avant tous les autres coûts applicables.
Un mouvement de prix rentable peut donc s’accompagner d’un gain plus faible sur le compte, et une opération sans variation de prix peut tout de même perdre de l’argent après les coûts. Le registre doit rendre ces différences visibles plutôt que ramener tous les changements de solde à un seul chiffre de résultat réalisé sur les transactions.
Utilisez les actifs de garantie et de frais réellement déclarés pour le marché et le compte concernés. Si une conversion en devise de présentation est nécessaire, conservez son instant de valorisation et les quantités d’origine. Les variations de valeur de l’actif de présentation ne doivent pas être confondues avec une amélioration de l’exécution de la stratégie sur contrats perpétuels elle-même.
Tenir un registre des clôtures partielles
Une sortie partielle doit répartir de manière cohérente les composantes économiques de la position tout en conservant l’exposition restante. Prenons une position longue fictive de deux unités ouverte à 500. Clôturer 0,75 à 510 crée un gain de 7,5 lié au prix. La clôture ultérieure des 1,25 restantes à 498 entraîne une perte de 2,5, laissant un gain brut de cinq lié au prix sur l’ensemble de la position.
Si les frais cumulés sont de 1,8 et que le financement est un débit de 0,4, le résultat net complet est de 2,8. Ne présenter que la première cession rentable surestimerait sensiblement le résultat. Présenter la position entière de deux unités comme clôturée après cette première exécution effacerait également le risque restant.
Les méthodes comptables peuvent différer dans leur présentation du prix d’entrée moyen et des composantes réalisées ; la reconstitution locale doit donc suivre la convention documentée et être rapprochée du compte. Conservez les exécutions et les flux de trésorerie sous-jacents même lorsque le rapport destiné à l’utilisateur présente une synthèse plus simple.
Surveiller la marge sans inventer de coussin de liquidation fixe
Le risque de liquidation dépend de l’exposition actuelle, des relations de garantie et des règles de maintenance. Une distance en pourcentage par rapport à un ancien prix d’entrée ne constitue pas une mesure complète. Les autres positions, le financement et les variations de valeur du compte peuvent affecter les ressources disponibles dans la configuration de marge active.
Utilisez les données actuelles pertinentes du compte et les paramètres des instruments. Une estimation calculée doit préciser ses hypothèses et ne doit pas être affichée comme une garantie que la liquidation ne peut pas survenir avant un certain prix. Des évolutions rapides et des prix de référence différents peuvent rendre trompeuse une borne simpliste.
La stratégie doit définir son comportement lorsque les données de marge requises sont indisponibles. Continuer à accroître l’exposition parce que le dernier coussin enregistré semblait confortable peut amplifier l’incertitude. Suspendre les nouvelles prises de risque tout en maintenant l’observation et la gestion autorisée des positions est une action différente de supposer qu’une position ouverte est devenue sûre simplement parce que le bot est en pause.
Reconstituer le compte avant la reprise après un redémarrage
Au démarrage, le système doit récupérer les intentions persistantes, les identifiants d’ordres acceptés, les reliquats ouverts, les exécutions, les événements de financement et les transferts pertinents. Il doit ensuite comparer cette reconstitution à l’état actuel du compte. Une connexion fonctionnelle ne suffit pas à établir que la stratégie connaît ses obligations existantes.
Les interventions manuelles doivent être incluses. Si l’utilisateur a réduit une position pendant que le processus était hors ligne, le bot ne doit pas rétablir automatiquement l’ancienne taille pour la faire correspondre à sa mémoire locale périmée. La modification externe du compte atteste que l’état opérationnel a changé et peut nécessiter une nouvelle décision concernant les règles à appliquer.
Ne reprenez les nouvelles entrées que lorsque les enregistrements requis les justifient. Les écarts inexpliqués doivent rester visibles et faire l’objet d’un périmètre d’enquête défini. Écraser discrètement le registre local avec un unique total actuel peut masquer des exécutions comptées en double, des coûts manquants ou un ordre annulé qui a été partiellement exécuté avant de disparaître de la liste des ordres ouverts.
Simuler une sortie interrompue
Un exercice fictif utile commence par une position longue de trois unités et une demande reduce-only visant à en clôturer deux. La connexion est coupée après la soumission. Pendant l’interruption, 1,5 unité est exécutée, et l’ordre correspondant à la demi-unité restante est annulé par la suite. La position correcte qui en résulte est une position longue de 1,5 unité, en l’absence de toute autre activité.
Le processus de reprise doit retrouver à la fois l’exécution et le reliquat annulé. Il ne doit ni supposer que les deux unités prévues ont été clôturées, ni soumettre une nouvelle sortie de deux unités uniquement parce que la réponse initiale manque. Toute réduction supplémentaire doit être fondée sur la position actuelle de 1,5 unité et sur les règles actives.
Prolongez l’exercice en rejouant le même message d’exécution. L’exposition doit rester inchangée après déduplication. Ce scénario met à l’épreuve plusieurs aspects importants à la fois : l’identité persistante, l’exécution partielle, l’annulation, le redémarrage et la protection contre une inversion involontaire. Le test réussit lorsque le compte final est expliqué, et non lorsque chaque demande reçoit une réponse rapide.
Évaluer l’automatisation à travers la position qu’elle laisse
Un bot de contrats perpétuels doit être évalué selon sa capacité à maintenir des enregistrements corrects des positions et des ressources, en fonctionnement ordinaire comme lors d’interruptions. Des demandes rapides ne sont utiles que si l’application peut identifier le compte, interpréter chaque résultat et expliquer l’exposition qui subsiste.
Examinez ensemble les tentatives achevées et celles qui restent non résolues. Consignez la fréquence à laquelle la stratégie a nécessité une reprise, les hypothèses qui ont changé et le respect des limites internes lors d’opérations concurrentes. Distinguez les performances de trading du bon fonctionnement opérationnel afin qu’un mouvement de marché favorable ne masque pas un cycle de vie des ordres défectueux.
Un bot de trading de contrats perpétuels Hyperliquid compréhensible relie une intention encadrée aux exécutions réelles, reconnaît le financement comme un flux de trésorerie à part entière et gère les sorties en fonction des positions actuelles. Ces pratiques ne peuvent pas supprimer le risque des produits dérivés, mais elles donnent à l’utilisateur une base cohérente pour décider de ce que le compte est autorisé à faire ensuite.