Passer à la Portfolio Margin

La Portfolio Margin (PM) est en production et ouverte à tous les comptes. Elle calcule la marge de vos options et de vos contrats perpétuels Hyperliquid ensemble, sur la base du risque de portefeuille dans le pire scénario. Un portefeuille couvert exige donc beaucoup moins de collatéral qu'en Standard Margin. Cette page explique comment y accéder. Pour le calcul de la marge lui-même, consultez Portfolio Margin.

En bref : utilisez un nouveau portefeuille gestionnaire, créez son compte Hypercall, activez le mode compte unifié de HyperCore, passez en mode Portfolio, et seulement ensuite effectuez votre dépôt.

Pourquoi partir d'un nouveau portefeuille

Un compte Standard Margin (SM) qui détient un solde ou des positions ouvertes ne peut pas être converti sur place en Portfolio Margin. Hypercall n'accepte le passage en mode Portfolio que si toutes ces conditions sont remplies pour le portefeuille gestionnaire :

Condition	Signification
Exactement un compte Hypercall	Le gestionnaire contrôle un seul contrat Account. Aucun compte, ou plusieurs, entraîne un refus.
Solde Standard nul	Le solde en cash Standard Margin du portefeuille est nul. Tout solde retirable bloque le changement.
Aucune exposition	Aucune position ouverte ni aucun ordre ouvert, sur le portefeuille gestionnaire ou sur son Account.

Ces règles existent parce que les deux modes correspondent à des types de compte différents, et non à un même compte avec un paramètre :

• Votre collatéral est détenu différemment. Passer de la Standard à la Portfolio Margin implique de déplacer vos fonds, pas de basculer un interrupteur.
• Les positions sont soumises à des règles de marge différentes. Une position ouverte devrait être recalculée d'un jeu de règles à l'autre.
• Le changement se fait donc à partir d'un compte vide. Effectuer les deux opérations en toute sécurité en une seule étape n'est pas pris en charge. C'est pourquoi le compte doit d'abord être sans position et vide.

Le mode de marge est défini par portefeuille gestionnaire : un même portefeuille ne peut pas fonctionner dans les deux modes. Le plus simple est d'utiliser un nouveau portefeuille gestionnaire pour la PM, ce qui permet à votre compte SM existant de continuer à coter pendant la configuration. Vous pouvez aussi vider votre portefeuille existant (tout clôturer, annuler tous les ordres, retirer tout le cash Standard) puis le convertir, mais vous ne pourrez pas maintenir votre activité SM pendant ce temps.

Avant de commencer

• Un nouveau portefeuille gestionnaire (un EOA que vous contrôlez, idéalement sur une clé matérielle ou autrement sécurisée).
• Du HYPE sur HyperEVM dans ce portefeuille, pour le dépôt de création du compte et les frais de gas.
• Les USDC que vous comptez utiliser comme collatéral.

Étapes de configuration

Suivez ces étapes dans l'ordre. L'étape 4 doit précéder l'étape 5.

1. Créez un nouveau portefeuille gestionnaire. Ne réutilisez pas votre gestionnaire SM, un portefeuille API ou une clé d'agent.

2. Créez votre compte Hypercall. Depuis le portefeuille gestionnaire, appelez createAccount(salt) sur le contrat Factory avec le dépôt de création en HYPE. Cela déploie votre contrat Account et l'active sur HyperCore. Voir Onboarding (contrats). Ne créez qu'un seul compte pour ce gestionnaire.

3. Activez le mode compte unifié de HyperCore pour l'Account. Soumettez l'action hl_set_abstraction, signée par le portefeuille gestionnaire, avec user défini sur l'adresse de votre Account et abstraction défini sur 2 (compte unifié). POST /v1/actions/hl_set_abstraction/typed-data renvoie les données typées exactes à signer, et POST /v1/actions/hl_set_abstraction les soumet. Attendez que HyperCore indique l'Account comme unifiedAccount. Les autres modes de compte de Hyperliquid, y compris son propre mode portfolio margin, ne sont pas pris en charge.

4. Passez en mode Portfolio. Envoyez POST /margin-mode avec wallet défini sur votre adresse de gestionnaire et margin_mode défini sur portfolio, signé par le portefeuille gestionnaire (voir Authentification). La réponse renvoie l'adresse de votre Account comme portefeuille PM. Faites-le avant tout dépôt : tant qu'un portefeuille est en mode Standard, un dépôt Hypercall est crédité en cash Standard, et ce solde bloque ensuite le changement jusqu'à ce que vous le retiriez.

5. Déposez des USDC sur votre Account. Effectuez le dépôt via l'application, qui oriente les fonds selon le mode de marge, ou envoyez des USDC sur HyperCore à l'adresse de votre Account. Les fonds sont pris en compte dans la marge dès que le prochain snapshot HyperCore de Hypercall les affiche.

6. Configurez vos clés de signature. Les autorisations de votre ancien portefeuille SM ne sont pas transférées.

   • Options (REST) : autorisez votre clé de trading pour le nouveau portefeuille gestionnaire avec POST /approve-agent. Voir Autorisation des agents.
   • Contrats perpétuels (directives on-chain) : enregistrez un portefeuille API sur votre Account avec l'action hc_update_api_wallet signée par le gestionnaire. Un portefeuille API ne peut être actif que sur un seul Account. Voir Signature EIP-712.

7. Tradez. Continuez à envoyer votre adresse de gestionnaire comme wallet dans vos requêtes sur les options ; Hypercall les achemine vers votre compte PM. Les types d'ordres, l'API d'ordres et la signature sont identiques à ceux de la Standard Margin. Pour les contrats perpétuels Hyperliquid depuis l'application, voir Perpétuels sur Hypercall.

Dans l'application, choisir Portfolio dans Settings > Margin Mode exécute les étapes 2 à 4 pour vous : le compte est créé si vous n'en avez pas, le mode compte unifié est activé, puis le mode de marge est changé.

Si vous ignorez le mode compte unifié

Hypercall valorise un compte PM à partir de son equity HyperCore, que HyperCore ne publie que pour les Accounts en mode compte unifié. Si l'Account n'est pas dans ce mode, l'étape 4 est refusée avec 400 pm_account_not_unified. Terminez l'étape 3, attendez que HyperCore confirme le mode, puis réessayez.

Si un Account quitte ultérieurement le mode compte unifié, les lectures du portefeuille renvoient 503 pm_account_equity_pending (ou 409 pm_account_not_unified si HyperCore n'a jamais publié d'equity pour cet Account), et les ordres échouent avec une erreur du type missing HyperCore account equity for PM wallet 0x.... Réactivez le mode compte unifié pour corriger le problème. Voir Erreurs et motifs de rejet.

FAQ

Puis-je conserver mon compte Standard Margin actif ? Oui. Configurez la PM sur un nouveau portefeuille gestionnaire et laissez votre compte SM tel quel.

Pourquoi mon changement de mode de marge a-t-il été refusé ? L'erreur indique la règle concernée : le portefeuille n'a pas d'Account (ou en a plusieurs), il détient un solde Standard, il a des positions ou des ordres ouverts, ou l'Account n'est pas encore en mode compte unifié HyperCore (pm_account_not_unified). Voir Pourquoi partir d'un nouveau portefeuille.

J'ai effectué un dépôt avant le changement de mode. Que faire ? Le dépôt a été crédité en cash Standard. Retirez-le, puis passez en mode Portfolio et déposez sur votre Account.

Ai-je besoin de nouvelles clés API ? Vous avez besoin de nouvelles autorisations. Les autorisations d'agent pour les options sont liées au portefeuille gestionnaire : autorisez donc à nouveau votre clé pour le nouveau. Un portefeuille API pour les contrats perpétuels ne peut être actif que sur un seul Account : utilisez donc une nouvelle clé ou retirez-la d'abord de votre ancien Account (étape 6).

Où trouver le fonctionnement de la marge, de la liquidation et du règlement en PM ? Voir Portfolio Margin, Exemples de calcul de marge PM, Plancher de marge, Liquidation et Règlement.