Un bot de contrats perpétuels Hyperliquid gère des positions sur des produits dérivés perpétuels, et non un simple stock de jetons. Ses décisions doivent tenir compte de la taille des positions, des garanties, du financement et des conditions pouvant entraîner une liquidation. Un système qui passe correctement un ordre peut malgré tout mal gérer ces risques s’il considère le levier comme un réglage de sécurité fixe ou suppose qu’une sortie déclenchée a déjà été exécutée.

Ce guide explique les mécanismes nécessaires pour évaluer une stratégie automatisée sur contrats perpétuels. Il distingue l’identité du contrat, le mode du compte et l’état de la position, puis suit des exemples hypothétiques au fil des variations de marge et des sorties partielles. Il ne recommande aucun niveau de levier et ne laisse pas entendre qu’une stratégie quelconque produit des rendements fiables. L’objectif est de rendre compréhensibles les engagements économiques et les obligations qui perdurent avant de les automatiser.

Identifier le produit dérivé négocié

Un contrat perpétuel crée une exposition à un prix de référence sans nécessiter la détention du jeton sous-jacent au comptant. L’identité de son marché, ses garanties et ses spécifications comptent indépendamment d’un symbole boursier familier. La présence du même nom d’actif dans une liste de marchés au comptant ne prouve pas que le produit dérivé visé présente des conditions identiques.

Hyperliquid comprend différents contextes de marchés de contrats perpétuels, dont des marchés exploités par leurs déployeurs. Le bot doit déterminer le contrat réel et les spécifications pertinentes plutôt que supposer que tous les marchés utilisent les mêmes garanties ou la même configuration.

Le guide de sélection des marchés Hyperliquid explique plus largement la distinction entre le comptant, les produits dérivés et HyperEVM. Le mandat portant sur les contrats perpétuels doit rester explicite afin que le système ne puisse pas substituer un achat de jetons à un ordre sur produit dérivé, ou l’inverse.

Consignez les paramètres actuels du contrat utilisés pour prendre la décision. Les pas minimaux des ordres, les exigences de marge et les modes pris en charge peuvent déterminer la validité d’une taille proposée. Une cotation ou un graphique ne suffit pas à établir l’ensemble des spécifications de négociation.

Lire le mode du compte avant son solde

La documentation actuelle d’Hyperliquid distingue les modes de compte standard, unifié et à marge de portefeuille. Le mode influe sur les interactions entre les soldes et les garanties. Un bot doit lire la configuration réelle du compte plutôt que la déduire du réglage actuellement proposé par défaut dans l’interface.

Dans une configuration standard, les soldes et le périmètre de la marge croisée peuvent être séparés selon le contexte de négociation. Les modes unifié et à marge de portefeuille modifient ces relations selon leurs règles. Un champ de solde qui semble pertinent dans un mode peut ne pas donner une vue complète du compte dans un autre.

Cela compte lorsque plusieurs stratégies partagent le compte. Une opération au comptant ou une autre position sur produit dérivé peut affecter une capacité qu’un processus de contrats perpétuels supposait lui être réservée. La vue du compte doit refléter les obligations réellement partagées.

Le guide de configuration Hyperliquid souligne la nécessité d’identifier le compte exploité. Pour le trading de contrats perpétuels, cette identification comprend son mode et les relations entre ses garanties, et pas seulement l’adresse ayant signé la demande.

Vérifier la marge d’un bot de contrats perpétuels Hyperliquid

Les vérifications de marge d’un bot de contrats perpétuels Hyperliquid distinguent les capitaux propres, le notionnel de la position, la marge initiale et les exigences de marge de maintien. Ces grandeurs décrivent différents aspects du compte. Les appeler toutes « solde » crée une ambiguïté au moment où la précision compte le plus.

Le notionnel exprime la taille de l’exposition au marché selon la convention de prix du contrat. La marge correspond aux garanties qui soutiennent cette exposition. Les capitaux propres évoluent à mesure que les gains, les pertes, le financement et les autres mouvements du compte sont comptabilisés selon les règles applicables.

Pour une position linéaire fictive d’une valeur de 1 000 unités soutenue par 200 unités, le simple ratio du notionnel aux capitaux propres est de cinq. Ce ratio ne signifie pas que le compte peut supporter n’importe quel mouvement défavorable de 20 %. Les exigences de marge de maintien et les autres coûts peuvent imposer une intervention avant que les capitaux propres servant de soutien n’atteignent zéro.

Une vérification utile avant de passer un ordre consiste à déterminer comment l’exécution proposée modifie à la fois l’exposition et la capacité restante. Elle doit intégrer les positions existantes et les ordres ouverts pertinents, plutôt que considérer la marge initiale du nouvel ordre comme la seule obligation du compte.

Le levier maximal autorisé par un contrat est une contrainte de la plateforme d’échange, pas une recommandation pour le compte. Une stratégie peut adopter un plafond d’exposition inférieur pour ses propres raisons. Réussir le contrôle d’admission de la plateforme établit qu’un ordre respecte ces exigences à cet instant ; cela n’établit pas que le budget global de perte de l’utilisateur est approprié.

Comprendre séparément la marge croisée et la marge isolée

La marge croisée mutualise les garanties entre les positions incluses selon les règles applicables au compte. La marge isolée affecte des garanties à un contexte de position particulier. Cette distinction modifie les autres avoirs susceptibles d’être affectés lorsqu’une position se dégrade.

L’isolation ne garantit pas que les fonds affectés à la position sont en sécurité. Elle définit le périmètre des garanties utilisées dans ce cadre. L’opération peut toujours perdre la marge qui la soutient sous l’effet d’un mouvement défavorable et d’une liquidation.

Certains marchés ou certaines configurations imposent des restrictions supplémentaires. La documentation actuelle décrit des cas où le retrait de marge isolée est restreint et d’autres où la marge croisée n’est pas disponible. Un bot doit vérifier le comportement pris en charge pour le contrat concerné plutôt que proposer une commande supposant que toutes les options sont autorisées partout.

Conservez ce choix dans le journal des décisions. Modifier le mode de marge ou déplacer des garanties constitue une action économique qui a des conséquences pour les autres stratégies. Cela ne doit pas se produire comme une correction invisible chaque fois qu’un ordre échoue à une vérification de capacité.

Distinguer le levier sélectionné du levier effectif

Le réglage du levier utilisé à l’ouverture d’une position ne fige pas son risque ultérieur. Lorsque le prix et les capitaux propres évoluent, le rapport entre le notionnel de la position et les capitaux propres peut lui aussi changer. Le bot doit effectuer des calculs continus plutôt que conserver une étiquette permanente copiée lors de l’entrée.

Considérons une position longue linéaire fictive de deux unités ouverte à 100, avec 40 unités de capitaux propres pour la soutenir. Le notionnel initial est de 200 et le ratio simple est de cinq. À un prix de 95, la perte latente est de dix, ce qui laisse 30 de capitaux propres avant les coûts. Le notionnel actuel est de 190, donc le ratio est d’environ 6,33.

Le réglage sélectionné à l’entrée n’a pas eu besoin de changer pour que le levier effectif augmente. Le financement ou d’autres pertes sur le compte partagé pourraient encore modifier ce rapport.

Surveillez l’état réel de la position et du compte. Une étiquette indiquant un levier de cinq fois ne suffit pas si elle masque la diminution des capitaux propres et l’augmentation de la sensibilité apparues après l’entrée.

Utiliser correctement le prix de marquage, le prix de l’oracle et les prix d’exécution

Hyperliquid utilise différentes notions de prix à différentes fins. Le prix de marquage intervient dans le calcul de la marge, la liquidation et les résultats latents. Les calculs du financement utilisent la référence d’oracle applicable selon les règles du contrat. Les exécutions effectives établissent les prix d’exécution.

Le bot doit indiquer quel prix détermine chaque décision. Un graphique des dernières transactions peut différer du prix de marquage, et un ordre au marché peut être exécuté à des prix différents des deux références affichées lorsque la profondeur est limitée.

Supposons qu’un graphique fictif affiche une dernière transaction à 100 alors que le prix de marquage pertinent est de 99,20. Un compte dont la règle de surveillance utilise le prix de marquage ne doit pas rendre compte de sa situation de marge à partir de la dernière transaction simplement parce que ce nombre est le plus visible à l’écran.

Évitez de supposer que toutes les familles de contrats reposent sur une même construction de l’oracle. Les spécifications du marché concerné déterminent la référence. En pratique, il faut conserver la source du prix et l’utiliser pour la question à laquelle elle répond réellement.

Analyser le financement d’un bot de contrats perpétuels Hyperliquid

L’analyse du financement d’un bot de contrats perpétuels Hyperliquid suit les transferts périodiques entre les positions longues et les positions courtes. Le financement peut être un coût ou un crédit selon le taux et le sens de la position. Il est distinct des frais de négociation payés pour l’exécution.

La documentation actuelle décrit des paiements de financement horaires. Un taux projeté reste une estimation pour un intervalle futur, tandis qu’une écriture de financement réglée constitue un événement réel du compte. Le bot ne doit pas comptabiliser un crédit prévu comme un revenu réalisé.

Pour un intervalle fictif, un notionnel de 10 000 unités fondé sur l’oracle et un taux de financement de 0,01 % impliquent un paiement d’une unité dans le sens applicable. Ce taux est un exemple, pas une offre actuelle. Dix intervalles de ce type, à notionnel et taux inchangés, représenteraient au total dix unités, mais aucune des deux données d’entrée n’est garantie de rester constante.

Conservez chaque écriture réglée avec sa position et sa période de reporting. Une opération qui semble rentable sur la seule base des prix d’entrée et de sortie peut présenter un résultat différent une fois le financement intégré.

Ne pas considérer l’encaissement du financement comme un rendement sans contrepartie

Une position qui reçoit du financement reste exposée au marché. Un paiement favorable peut être plus que compensé par un mouvement défavorable du prix, une variation du taux, les coûts d’exécution ou une couverture imparfaite. Cet encaissement ne rend pas la position équivalente à des liquidités.

Supposons qu’une stratégie fictive gagne 12 unités de financement tout en perdant 35 sur le mouvement du prix et en payant sept au total en frais de négociation. Son résultat net est de moins 30. Ne présenter que le rendement du financement omettrait l’effet économique le plus important.

Une couverture soulève ses propres questions de compte et d’exécution. Ses deux jambes peuvent ne pas être exécutées ensemble, utiliser des garanties différentes et connaître une évolution de la relation entre leurs prix. Un bot doit identifier l’exposition résiduelle plutôt que qualifier le montage de neutre par hypothèse.

Évaluez les idées fondées sur le financement à l’aide de scénarios complets. Incluez une inversion du taux, un ajustement retardé de la couverture et une période pendant laquelle la position doit être réduite à un prix défavorable. Le nom de la stratégie ne fait pas disparaître ces coûts possibles.

Considérer la liquidation comme une contrainte permanente

Le risque de liquidation dépend des capitaux propres du compte et des exigences de marge de maintien selon les règles réelles du marché et du compte. Il ne correspond pas simplement à un pourcentage fixe sous le prix d’entrée pour toute position longue ou au-dessus pour toute position courte.

Les résultats entre comptes, le financement et les variations des garanties peuvent modifier la condition de liquidation estimée. Un bot doit actualiser la vue pertinente du compte plutôt que considérer l’estimation affichée avant l’entrée comme permanente.

Le prix de marquage utilisé pour la liquidation peut également différer du prix visible sur le graphique privilégié. Un système de surveillance qui ne suit que la dernière transaction peut manquer la condition pertinente pour l’évaluation de la marge du compte.

Ne prévoyez pas de remplacer une sortie ordinaire par la liquidation. Il s’agit d’un processus de maîtrise du risque imposé, dont l’issue dépend des conditions du moment. Une stratégie a besoin de ses propres règles de réduction, tout en reconnaissant que ces règles peuvent elles aussi se heurter à des discontinuités de prix, à une profondeur limitée et à l’incertitude d’exécution.

Contrôler les sorties d’un bot de contrats perpétuels Hyperliquid

Les contrôles de sortie d’un bot de contrats perpétuels Hyperliquid doivent distinguer la condition qui active un ordre du prix et de la quantité effectivement exécutés. Le déclenchement d’un stop donne l’instruction de tenter une action définie lorsque sa condition est remplie ; il ne garantit pas l’obtention du prix de déclenchement.

La documentation actuelle d’Hyperliquid utilise le prix de marquage pour les déclenchements de take-profit et de stop-loss. Un bot doit confirmer les modalités des ordres prises en charge et afficher la référence utilisée plutôt que laisser l’utilisateur la déduire d’un graphique des dernières transactions.

Un ordre stop-limit peut rester inexécuté si le marché dépasse son prix acceptable. Un ordre de protection exécuté au marché peut être exécuté à un prix moins favorable que le seuil de déclenchement et reste soumis aux contraintes d’exécution réelles de la plateforme.

Le guide d’automatisation de l’état des ordres explique pourquoi les états soumis, actif, déclenché et exécuté nécessitent des éléments de preuve distincts. Le compte reste exposé à la quantité non clôturée tant que les exécutions n’établissent pas qu’elle a été réduite.

Utiliser les ordres reduce-only conformément à leur fonction réelle

Les ordres reduce-only visent à réduire une position existante plutôt qu’à ouvrir une exposition dans le sens opposé. Cela est utile lorsqu’une quantité de sortie pourrait autrement dépasser la position après qu’une autre action en a modifié la taille.

Pour un compte fictif ayant une position longue de dix unités, une vente prévue de dix doit clôturer la position si elle est exécutée comme prévu. Si une autre action réduit d’abord la position à six, une vente sans restriction de dix pourrait laisser une position courte de quatre unités. Une instruction reduce-only prise en charge limite ce comportement d’inversion.

Elle ne garantit ni une exécution ni un prix particulier. Le bot doit toujours vérifier l’état accepté de l’ordre et la position restante après l’exécution.

Maintenez les ordres de protection en phase avec les positions réelles. Un examen utile vérifie leur sens, leur quantité, leur référence de déclenchement et leur statut actuel. Une étiquette de sortie rassurante ne doit pas masquer un ordre annulé, jamais activé ou dimensionné pour une position antérieure.

Rapprocher les entrées partielles et les ordres de protection

Un ordre d’entrée peut être partiellement exécuté tandis que son reliquat reste ouvert ou est annulé. L’exposition acquise diffère alors de l’objectif initial. Le bot doit rapprocher à la fois la position réelle et les ordres de protection qui lui sont associés.

La documentation actuelle distingue les ordres de protection liés à une position des ordres enfants liés à un ordre parent. Leur comportement en cas d’exécution incomplète et d’annulation n’est pas identique. En particulier, l’annulation manuelle d’un ordre parent partiellement exécuté peut annuler les protections enfants qui lui sont associées selon le déroulement documenté.

La leçon opérationnelle consiste à examiner l’état obtenu plutôt que supposer que l’annulation de l’entrée non exécutée laisse la portion exécutée protégée. Une action de protection distincte peut être nécessaire selon le processus pris en charge choisi.

Par exemple, une entrée prévue de huit unités dont trois sont exécutées crée trois unités d’exposition. Les cinq unités restantes représentent un engagement au titre d’un ordre, pas des avoirs supplémentaires. Les deux catégories doivent être rapprochées avant que le bot présente l’entrée en position comme complète ou la clôture comme effectuée en toute sécurité.

Rapprocher les entrées partielles et les ordres de protectionPosition ResultPrice MovementTrading FeesFunding PaymentsRemaining ExposureTRADING FIELD NOTESEDUCATIONAL RESOURCE
Le résultat d’une stratégie sur contrats perpétuels combine les variations de prix réalisées, les frais, le financement et toute position restant ouverte.

Réserver la capacité entre les stratégies simultanées

Plusieurs processus de stratégie peuvent chacun constater une capacité du compte apparemment suffisante alors que leurs propositions cumulées dépassent la limite prévue. Des garanties partagées nécessitent une logique commune de réservation cohérente avec le mode réel du compte.

Supposons qu’un compte fictif autorise 600 unités de notionnel supplémentaire selon ses propres règles de risque. Deux processus proposent chacun 400 presque au même moment. Chaque proposition est admissible isolément, mais elles nécessitent ensemble 800 et dépassent de 200 la limite fixée par ces règles.

Réservez la capacité avant de préparer les actions finales, et maintenez les réservations pour les ordres non résolus jusqu’à ce que leur état soit connu. Une demande d’annulation n’équivaut pas à une libération confirmée de toutes les obligations restantes.

Le guide de coordination du portefeuille explique le problème général de répartition du budget. Pour les contrats perpétuels, le calcul agrégé doit aussi prendre en compte la manière dont les mouvements de prix et les garanties partagées modifient la capacité disponible après l’admission des ordres initiaux.

Séparer les transferts de la performance de trading

L’ajout de garanties peut empêcher le compte d’afficher une baisse de ses capitaux propres tout en laissant la stratégie en perte sur ses opérations de trading. Un retrait peut réduire le solde affiché sans représenter une perte. La performance doit tenir compte de ces flux externes.

Pour une période fictive, un compte commence avec 500 unités, reçoit un dépôt de 200 unités et termine avec 650. En ignorant les complications de valorisation et en supposant l’absence de retrait, le résultat des opérations de trading et des frais est de moins 50. Le solde final est supérieur au solde initial uniquement parce que de nouveaux capitaux ont été apportés.

Distinguez les transferts internes entre les contextes de compte des dépôts entrant dans le portefeuille faisant l’objet du reporting. Sinon, le déplacement de garanties peut apparaître comme de l’argent nouvellement gagné dans une stratégie et comme une perte inexpliquée dans une autre.

Le guide de comptabilisation des bénéfices présente la distinction fondamentale entre les flux de trésorerie et les résultats. Le reporting des contrats perpétuels ajoute le financement et la valorisation des positions sur produits dérivés, mais ne supprime pas la nécessité d’identifier les apports et les retraits.

Calculer le résultat complet d’une position clôturée

Considérons une position longue linéaire fictive de quatre unités ouverte à 50 et entièrement clôturée à 54. Le gain brut lié au prix est de quatre fois quatre, soit 16 unités. Supposons que les frais d’entrée et de sortie totalisent trois, et que le financement net payé pendant la détention soit de deux.

Le résultat complet est de 11 unités avant tous les autres coûts non comptabilisés. Il ne correspond pas au gain de 16 unités lié au prix affiché isolément. Si la stratégie a également payé une unité pour des tentatives infructueuses imputables à la même période de reporting, le résultat global de la période devient dix.

Pour les sorties partielles, conservez la quantité restante et une méthode cohérente de calcul du prix d’entrée. Les gains réalisés sur une portion clôturée ne doivent pas effacer les pertes ou les obligations sur le reliquat ouvert.

Présentez les rendements avec un dénominateur clairement défini. Le rendement de la marge déposée, le rendement des capitaux propres moyens et le rendement rapporté au notionnel répondent à des questions différentes. Choisir le plus petit dénominateur uniquement parce qu’il produit le pourcentage le plus élevé rend les comparaisons trompeuses.

Surveiller conjointement les variations des garanties et du marché

La capacité du compte à soutenir une position dépend d’autres éléments que le seul prix de cette position. Les autres positions, le financement, les retraits et les règles relatives aux garanties peuvent modifier le coussin disponible. Ne surveiller que le marché ciblé laisse une partie du risque sans observation.

Définissez des conditions distinctes pour augmenter l’exposition et pour la réduire. Une stratégie peut cesser d’ouvrir de nouvelles positions lorsque les éléments disponibles sur le compte deviennent obsolètes, tout en continuant à rapprocher les ordres existants et à permettre les réductions autorisées.

Évitez de considérer un apport supplémentaire de garanties comme une preuve que la règle de trading reste pertinente. Ajouter des capitaux modifie la capacité du compte ; cela n’annule pas la perte de marché et ne valide pas la thèse initiale.

Conservez le motif de chaque intervention. Un examinateur ultérieur doit pouvoir distinguer une stratégie rentable d’une stratégie dont la stabilité apparente dépendait de dépôts répétés non déclarés ou de modifications discrétionnaires du budget de risque.

Tester les discontinuités et les redémarrages avant d’élargir le périmètre

Une simulation pertinente inclut une entrée incomplète, un stop qui se déclenche sans être entièrement exécuté, une inversion du taux de financement et une période où les messages du marché et du compte arrivent dans le désordre. La seule réussite de la passation d’ordres ne met pas ces obligations à l’épreuve.

La reprise après redémarrage doit reconstituer les positions actuelles, les ordres ouverts, les ordres de protection et les exécutions récentes avant de lancer de nouvelles actions. Rejouer un ancien signal sur un compte dont l’état a changé peut créer une exposition involontaire, même lorsque le signal initial était valide.

Évaluez si le bot explique son incertitude. Une réponse manquante doit entraîner une tâche de rapprochement plutôt qu’un succès ou un échec inventé. L’utilisateur doit savoir quelle quantité reste exposée et quels éléments de preuve manquent encore.

Un processus bien défini sur les contrats perpétuels Hyperliquid relie chaque ordre à un contrat, à un mode de compte et à un budget de risque, puis continue de vérifier la position jusqu’à sa clôture. Son utilité réside dans le fait de rendre ces obligations explicites et vérifiables tout au long de l’opération, y compris pendant les périodes où les conditions du marché sont défavorables.

Poursuivre l’apprentissage

Explorer toutes les ressources