MetaMask Agent Wallet négocie des contrats à terme perpétuels sur Hyperliquid via l'ensemble de commandes mm perps. Un trader demande à son agent une position en langage naturel, et l'agent achemine cette requête vers les commandes qui déposent la garantie, récupèrent un devis, ouvrent la position, définissent les niveaux de prise de profit et de stop loss, puis la ferment ou la redimensionnent ultérieurement. Le wallet conserve la garde ; les dépôts sont soumis à une vérification de politique, et l'agent se contente de proposer.
C'est cette passation de relais qui distingue le trading de contrats perpétuels piloté par un agent du simple clic dans une interface. Une seule phrase peut contenir de nombreuses hypothèses implicites sur le type d'ordre, le slippage et la taille. Cet article couvre les détails qu'il vaut mieux expliciter, notamment les parties de ce flux de travail que les contrôles au niveau du wallet MetaMask atteignent réellement, et celles qu'ils n'atteignent pas.
Il s'agit d'un guide sur la mécanique du trading, pas d'une introduction aux contrats perpétuels. Pour comprendre ce que sont les contrats à terme perpétuels et comment ils sont valorisés, consultez le trading de contrats perpétuels pour débutants et les concepts essentiels des contrats à terme perpétuels. Pour les calculs liés au dimensionnement des positions, consultez levier et marge dans le trading de contrats à terme perpétuels. Pour la catégorie de wallet elle-même, consultez qu'est-ce qu'un agentic wallet et comment fonctionnent les agentic wallets.
La surface des contrats perpétuels, en un tableau
Voici les commandes sur lesquelles s'appuie un flux de travail de trading de contrats perpétuels. Connaître cette surface facilite la formulation d'une requête qui aboutit au résultat souhaité.
Ce que vous demandez à votre agent | Ce qui s'exécute | Ce que ça fait |
« Quels marchés de contrats perpétuels sont disponibles » | mm perps markets
| Liste les symboles négociables sur la plateforme |
« Alimente mon compte de contrats perpétuels avec 500 USDC » | mm perps deposit
| Dépose des USDC sur la plateforme |
« Combien coûterait un long 5x sur BTC » | mm perps quote
| Évalue la position sans la soumettre |
« Ouvre un long 5x sur BTC avec 100 $ » | mm perps open
| Soumet l'ordre |
« Définis un stop à 58 000 » | mm perps modify
| Attache une prise de profit, un stop loss ou un nouveau levier |
« Affiche mes positions ouvertes » | mm perps positions
| Lit l'exposition actuelle |
« Ferme ma position BTC » | mm perps close
| Ferme totalement ou partiellement |
« Annule cet ordre en attente » | mm perps cancel
| Annule par identifiant d'ordre |
« Transfère 200 USDC vers le spot » | mm perps transfer
| Déplace la garantie entre les soldes spot et perpétuels |
Source : référence des commandes MetaMask Agent Wallet.
Avec cette compréhension de base, voici 9 conseils essentiels pour utiliser MetaMask Agent Wallet afin de trader des contrats perpétuels.
1. Alimenter le compte de contrats perpétuels avant la première requête
Le sous-compte Hyperliquid est vide lors de la première utilisation. Demander à un agent d'ouvrir une position avant qu'une quelconque garantie soit arrivée peut échouer avec HYPERLIQUID_ERROR ou ORDER_REJECTED, et l'agent n'a rien d'utile à retenter.
mm perps deposit utilise par défaut des USDC provenant d'Arbitrum, donc des USDC doivent être disponibles sur Arbitrum, ou --source-chain-id doit pointer vers une chaîne où ils se trouvent. La garantie déjà présente dans le solde spot du wallet sur la plateforme peut être déplacée via mm perps transfer --direction spot-to-perp plutôt que par un nouveau dépôt.
Un chiffre à retenir : les ordres inférieurs à 10 $ en valeur notionnelle sont rejetés avec INVALID_AMOUNT, accompagnés d'une suggestion d'augmenter la taille de la position ou le levier. Les petits trades de test doivent dépasser ce seuil.
2. Demander un devis avant d'ouvrir, ou prévisualiser avec un dry run
mm perps quote évalue une position sans la soumettre. mm perps open --dry-run va plus loin et valide l'intégralité de l'ordre sans le signer ni le soumettre.
Ces deux options sont plus importantes avec un agent qu'avec une interface manuelle, car l'étape de confirmation qu'un trader lirait normalement à l'écran peut être ignorée sur instruction de l'agent. Un devis ou un dry run remet les chiffres devant un humain avant que quoi que ce soit ne soit signé.
3. Préciser « limit » si un ordre à cours limité est souhaité
mm perps open accepte --type market ou --type limit, et un ordre à cours limité requiert --limit-px. Une requête formulée comme « ouvre un long 5x sur ETH avec 200 $ » ne contient aucune instruction de prix, elle est donc interprétée comme un ordre au marché.
Les ordres au marché traversent le spread et peuvent subir du slippage, c'est-à-dire la différence entre le prix d'exécution attendu et le prix réellement obtenu. Sur des marchés peu liquides, cet écart se creuse. Les traders soucieux du prix d'entrée le précisent généralement, tandis que ceux qui privilégient la certitude d'exécution ne le font généralement pas.
4. Plafonner le slippage à l'entrée et à la sortie
mm perps open et mm perps close acceptent tous deux --max-slippage-bps, un plafond exprimé en points de base. La documentation ne publie pas de valeur par défaut, donc un ordre soumis sans ce paramètre s'exécute selon ce que le CLI applique plutôt que selon un chiffre explicitement défini.
Définir le plafond explicitement est l'une des rares instructions qui contraignent une ouverture autonome d'une manière que l'agent ne peut pas réinterpréter. Il est aussi facile de l'oublier à la sortie, qui est la jambe où le slippage fait le plus mal, car les sorties se concentrent aux moments où tout le monde sort en même temps.
5. Attacher la prise de profit et le stop loss comme une deuxième étape délibérée
mm perps open n'accepte pas les niveaux de prise de profit ou de stop loss. Ceux-ci s'ajoutent avec mm perps modify --tp et --sl , qui requiert au moins l'un des paramètres --leverage, --tp ou --sl.
La conséquence pratique : une position ouverte par un agent n'a aucun ordre de sortie attaché tant que quelqu'un ne le demande pas. Un prompt qui dit « ouvre un long 5x sur BTC avec 100 $, puis définis un stop à 4 % sous le prix d'entrée et une prise de profit à 8 % au-dessus » décrit deux commandes et les obtient toutes les deux. Un prompt qui s'arrête après la première clause obtient une position sans protection. Définir les niveaux de sortie en même temps que l'entrée est ce qui évite que l'écart entre ces deux états ait de l'importance.
6. Savoir que c'est le dépôt, et non l'ordre, que MetaMask vérifie
Une seule étape d'un flux de travail de contrats perpétuels est une transaction EVM que les contrôles au niveau du wallet MetaMask évaluent réellement : le dépôt. Il passe par la détection des menaces dans les deux modes de trading. En mode Guard spécifiquement, il est également mesuré par rapport à la limite de sortie glissante sur 24 heures, que la documentation MetaMask nomme comme une catégorie incluse aux côtés des transferts de tokens et des swaps pour les dépôts vers Hyperliquid. Si le dépôt dépasse cette limite, ou si la détection des menaces le signale dans l'un ou l'autre mode, le job se met en pause dans AWAITING_MFA pour une approbation par authentification à deux facteurs, transmise sous forme de notification push MetaMask Mobile pour les connexions par QR code ou d'un lien par e-mail pour les connexions via navigateur, et l'agent ne peut pas continuer tant que quelqu'un ne répond pas. Cela s'applique au mode server-wallet ; les modes de trading ne s'appliquent pas aux configurations bring-your-own-wallet.
L'ouverture, la modification et la fermeture d'une position se produisent sur Hyperliquid lui-même, et non en tant que transactions EVM simulées par MetaMask. Ces actions ne sont pas soumises à la détection des menaces, ne consomment pas le budget de sortie, ne sont pas vérifiées par rapport aux listes d'autorisation, et ne déclenchent pas d'authentification à deux facteurs, quelle que soit la taille de la position. Un dépôt de 2 000 $ qui atteint la limite de sortie est scruté à l'entrée ; une position de 50 000 $ ouverte sur cette même garantie avec un levier de 25x ne fait l'objet d'aucun second examen de la part du wallet. La limite de sortie est un contrôle au moment du financement, pas un contrôle de la taille de la position, et la discipline de dimensionnement de l'ordre lui-même repose entièrement sur ce que dit le prompt et ce que l'agent en fait.
L'habitude pratique : alimenter le compte dans une étape délibérée et séparée, dimensionnée à ce qui est réellement destiné à être mis en risque, car c'est le seul moment où les garde-fous de MetaMask s'appliquent. Tout ce qui est en aval de ce dépôt relève du trader et de l'agent.
7. Se connecter toujours de la même façon
Google, e-mail sans mot de passe et MetaMask Mobile QR correspondent chacun à une adresse de server-wallet différente, même lorsque la même adresse e-mail est utilisée pour plusieurs d'entre eux. Étant donné que le compte Hyperliquid est alimenté depuis un wallet spécifique, se connecter d'une manière différente fait apparaître une adresse différente sans aucune de ces garanties.
L'habitude qui évite cela : choisir une méthode de connexion, l'utiliser à chaque fois, et exécuter mm wallet address après la connexion pour confirmer l'adresse attendue avant de faire quoi que ce soit. Les fonds restent là où ils étaient ; ils ne sont simplement pas visibles depuis la mauvaise session.
8. Cibler les DEX HIP-3 délibérément
Le solde, les positions et les ordres ciblent par défaut le DEX principal de Hyperliquid. --dex cible une requête vers un DEX HIP-3 spécifique, et --all-dexes agrège les données pour les lectures de solde et de positions sur l'ensemble d'entre eux.
Un agent à qui l'on demande « quelles sont mes positions » sans qualification ne rapporte que sur le DEX principal. Pour un portefeuille réparti sur plusieurs DEX, cette réponse est incomplète d'une manière qui n'est pas évidente à la lecture, ce qui rend --all-dexes utile à mentionner dans tout prompt destiné à produire une vue d'ensemble complète. mm perps dexs liste les identifiants disponibles.
Les paramètres de ciblage sont documentés sur les commandes de lecture plutôt que sur le placement d'ordres, donc --dex est mieux compris ici comme un contrôle de visibilité.
9. Utiliser les devis et les dry runs pour s'entraîner, pas le testnet
mm perps open --dry-run valide un ordre entièrement spécifié, incluant le symbole, le sens, la taille et le levier, sans le signer ni le soumettre. Combiné avec mm perps quote, un prompt de stratégie peut être exécuté de bout en bout sur des prix en direct pour confirmer ce que l'agent soumettrait réellement, avant qu'une quelconque garantie ne soit en jeu.
--network testnet existe sur les commandes de lecture et de trading, mais s'entraîner sur une stratégie en direct n'est actuellement pas pratique : le testnet de Hyperliquid utilise une variante USDC distincte accessible uniquement via faucet, qui n'est pas disponible via le chemin de financement d'Agent Wallet, donc un compte de contrats perpétuels sur testnet ne peut pas être alimenté de la même façon qu'un compte mainnet. Les dry runs et les devis sont les outils d'entraînement les plus fiables jusqu'à ce que cela soit résolu.
Pour la version en direct, --yes ignore le prompt de confirmation interactif sur open, close, modify et cancel, ce qui permet les flux planifiés ou scriptés. Ce que --yes ne fait pas, c'est désactiver les propres contrôles du wallet sur la jambe de dépôt décrite dans le conseil 6. Ignorer le prompt de confirmation supprime la lecture humaine de l'ordre ; cela ne modifie pas ce que MetaMask vérifie.
Ce qu'Agent Wallet ne fait pas pour les contrats perpétuels
Être clair sur la limite est plus utile que de laisser entendre qu'elle est plus large.
Il n'y a pas de moteur de stratégie intégré. Agent Wallet expose la surface de trading ; la logique de décision réside dans l'agent et dans ce que le trader lui indique. Il n'existe pas de fonctionnalité dédiée au copy-trading, de flux de signaux ou de rééquilibrage automatisé fourni pour les positions sur contrats perpétuels. Les traders souhaitant ce type de logique personnalisée peuvent la construire sous forme de plugin, une fonctionnalité bêta qui permet à un package npm installé d'ajouter de nouvelles commandes au CLI sous des capacités de lecture ou de soumission de transactions soumises à consentement, mais il s'agit d'un chemin à construire soi-même plutôt que d'une fonctionnalité intégrée.
Le financement s'accumule selon un calendrier défini par la plateforme, et rien dans le wallet ne le surveille pour le compte d'un trader. Maintenir une position à effet de levier sur plusieurs intervalles de financement entraîne un coût qui se cumule, comme expliqué dans la mécanique et le calendrier du financement des contrats à terme perpétuels. Un agent à qui l'on demande de vérifier le financement le vérifiera. Un agent à qui on ne le demande pas ne le fera pas.
Le comportement de la marge est défini par la plateforme plutôt que par le wallet. Pour la différence entre les deux modèles et ce que chacun implique pour la liquidation, consultez marge croisée vs marge isolée dans le trading de contrats perpétuels.
Hyperliquid. --venue est défini par défaut sur hyperliquid pour chaque commande mm perps, et mm perps list-venues retourne la liste actuelle des venues supportées.
Pas directement. Les deux sont appliqués lors du dépôt sur la plateforme, car c'est l'étape que MetaMask traite comme une transaction EVM, en mode server-wallet. L'ouverture, la modification et la clôture d'une position s'effectuent sur Hyperliquid même et ne sont pas soumises à la limite de flux sortant, aux listes d'autorisation, à l'analyse des menaces ou à l'authentification à deux facteurs, quelle que soit la taille de la position. Le contrôle s'exerce donc au moment de définir délibérément le montant du dépôt.
Les deux causes les plus fréquentes sont un compte de venue non approvisionné et un ordre inférieur au minimum notionnel de 10 $. mm perps deposit remplit le premier écart et mm perps balance le confirme. En cas de déficit de collatéral sur un compte existant, mm perps transfer --direction spot-to-perp transfère des fonds depuis le solde spot.
Via mm perps modify avec --tp et --sl, en tant qu'étape distincte de mm perps open. Une position ouverte sans cette étape de suivi n'a aucun ordre de sortie associé.
Oui. --dex limite les marchés, le solde, les positions et les ordres de mm perps à un DEX HIP-3 spécifique, et mm perps dexs liste les identifiants disponibles. Les lectures de solde et de positions acceptent également --all-dexes pour agréger les données sur l'ensemble des DEX.
mm perps open --dry-run valide et prévisualise un ordre entièrement spécifié sans le signer ni le soumettre, et mm perps quote évalue le prix d'une position par rapport aux marchés en direct en premier lieu. Le trading sur testnet est documenté, mais ne constitue pas encore un parcours de répétition pratique, car Agent Wallet ne peut actuellement pas alimenter un compte Hyperliquid testnet.
Pas en tant que fonctionnalité intégrée. Le système de plugins bêta d'Agent Wallet permet à un développeur de publier un package npm qui ajoute de nouvelles commandes à la CLI, sous réserve d'un consentement au moment de l'installation concernant ce que le plugin peut lire ou soumettre — c'est le point d'extension pour ce type de workflow personnalisé aujourd'hui.