Comment trader sur les marchés prédictifs avec MetaMask Agent Wallet : 9 conseils essentiels

MetaMask Agent Wallet négocie sur les marchés de prédiction Polymarket via l'ensemble de commandes mm predict. Un trader demande à son agent de vérifier les cotes, de calibrer une mise ou de réclamer et encaisser ses gains en langage naturel, et l'agent achemine cette demande vers les commandes qui alimentent un wallet de dépôt dédié, génèrent un devis de commande, la passent, la rachètent une fois résolue et retirent le produit.

Comme pour le trading de contrats à terme perpétuels sur Agent Wallet, et contrairement aux swaps, l'étape intermédiaire est celle qui se déroule hors bilan : passer et annuler une commande s'effectue hors chaîne sur le carnet d'ordres à cours limité centralisé de Polymarket, tandis qu'alimenter le wallet de dépôt et réclamer les gains résolus sont les deux étapes qui se comportent comme de vraies transactions évaluées par MetaMask.

Cette distinction est facile à manquer dans une seule invite. « Miser 20 $ sur une baisse des taux par la Fed » implique des hypothèses non formulées sur le prix, le type d'ordre et la fermeté requise de ce prix — des hypothèses qu'une interface parcourue étape par étape ferait apparaître sur des écrans distincts, mais qu'une phrase condense en une seule demande. Cet article couvre les détails qu'il vaut la peine d'expliciter avant qu'un agent agisse sur cette phrase.

Il s'agit d'un guide sur la mécanique de trading, pas d'une introduction aux marchés de prédiction. Pour comprendre ce que sont les marchés de prédiction et comment la tarification reflète la probabilité, voir qu'est-ce que Polymarket. Pour les carnets d'ordres, les spreads, la liquidité et la mécanique de résolution, voir les concepts essentiels des marchés de prédiction et comment fonctionne la tarification des marchés de prédiction. Pour la catégorie de wallet elle-même, voir qu'est-ce qu'un wallet agentique et comment fonctionnent les wallets agentiques. Pour la même distinction dépôt/ordre dans une autre classe d'actifs, voir comment trader des perps et comment swapper et bridger des tokens avec MetaMask Agent Wallet.

Une distinction importante à souligner d'emblée : mm predict est l'intégration Polymarket propre au CLI d'Agent Wallet, conçue pour les développeurs et les agents. C'est un produit distinct de MetaMask Predictions, la fonctionnalité grand public intégrée à MetaMask Mobile. Les deux tradent sur Polymarket, mais ce sont des interfaces différentes avec des commandes différentes, et cet article ne couvre que le CLI.

La surface des marchés de prédiction, décortiquée

Voici les commandes sur lesquelles s'appuie un workflow de marché de prédiction. Connaître la surface facilite la formulation d'une demande qui aboutit comme prévu.

Source : référence des commandes MetaMask Agent Wallet.

Avec cette compréhension de base, voici 9 conseils pour utiliser MetaMask Agent Wallet afin de trader sur les marchés de prédiction.

1. Exécutez la configuration une seule fois, puis alimentez un wallet distinct de votre solde spot

Le trading sur les marchés de prédiction passe par un wallet de dépôt predict dédié, et non par le solde de votre wallet principal. Le flux initial est mm predict setup --wait, suivi de mm predict deposit --amount --wait, qui convertit les USDC.e Polygon détenus dans votre wallet en pUSD dans ce wallet de dépôt. Sauter la configuration avant le dépôt peut produire un simple JsonRpcError: execution reverted plutôt qu'un code d'erreur clair.

Deux modes d'échec connexes à reconnaître : PREDICT_INSUFFICIENT_GAS signifie que le wallet a besoin de POL natif sur Polygon pour couvrir le gas de la transaction de dépôt, et PREDICT_INSUFFICIENT_ALLOWANCE signifie que l'autorisation de token doit être réparée avec mm predict approve avant qu'un dépôt ou un ordre puisse aboutir. Les deux ne sont qu'à une commande d'être résolus, mais seulement une fois correctement identifiés.

Le géoblocage est également le plus susceptible de se manifester ici, avant qu'un seul ordre soit passé — si la région du compte est restreinte, c'est généralement au niveau de setup ou deposit que cela apparaît comme un échec, pas plus tard à l'étape de l'ordre. Vérifiez mm predict geoblock avant d'alimenter le wallet plutôt qu'après (plus de détails au conseil 6), et ne traitez pas un résultat null comme un bilan de santé satisfaisant : la vérification du géoblocage peut renvoyer null pour un compte restreint, et l'agent ne distingue pas aujourd'hui de manière fiable cela d'un résultat explicitement autorisé, même si cela signifie la même chose opérationnellement. Traitez un résultat ambigu comme un blocage jusqu'à confirmation contraire.

2. Sachez que l'ordre, et non le dépôt ou le rachat, est ce qui échappe au radar du Guard Mode

C'est le même schéma que le trading de contrats à terme perpétuels sur Agent Wallet, et non le schéma des swaps — mais pour les marchés de prédiction, c'est l'étape intermédiaire qui est hors chaîne, pas seulement une extrémité. La politique de sortie de MetaMask désigne « les dépôts (par exemple, vers Uniswap, Polymarket ou Hyperliquid) » comme ce qui compte dans la limite de sortie glissante sur 24 heures — Polymarket est cité nommément, de la même façon qu'Hyperliquid. Cela signifie que la transaction d'alimentation vers le wallet de dépôt predict est ce que la limite de sortie du Guard Mode, les listes d'autorisation et l'authentification à deux facteurs évaluent. mm predict place et mm predict cancel sont des appels synchrones vers le carnet d'ordres de Polymarket, et non des transactions EVM — ils ne sont donc pas vérifiés par ces garde-fous, quelle que soit leur taille.

Le rachat mérite d'être mentionné séparément : mm predict redeem est documenté avec --wait, le même schéma basé sur les jobs utilisé pour mm predict setup et mm predict deposit, que la page d'architecture décrit comme la signature d'une demande de signature ou de transaction qui passe par la simulation, l'analyse des menaces et l'évaluation des politiques. C'est un signal fort que réclamer une position résolue est une vraie transaction on-chain, et non une action hors chaîne sur le carnet d'ordres comme passer ou annuler un ordre — traitez donc l'étape de rachat avec le même soin que le dépôt, et non de la même façon qu'un ordre.

L'analyse des menaces est le seul garde-fou qui ne se divise pas par étape comme le fait la limite de sortie : elle s'applique en Guard Mode et en Beast Mode, selon la comparaison des modes de trading — seules la limite de sortie et les listes d'autorisation sont exclusives au Guard Mode. Cela s'applique au mode server-wallet ; les modes de trading ne s'appliquent pas aux configurations bring-your-own-wallet. La conséquence pratique : un trader calibrant un seul ordre n'a pas besoin de penser à la limite de sortie au moment de le passer, mais alimenter le wallet de dépôt, puis racheter un gain, sont les deux moments où cette discipline s'applique encore.

3. --limit-price prévisualise, --price passe — ils ne sont pas interchangeables

mm predict quote accepte un --limit-price optionnel pour prévisualiser le coût à un prix spécifique. mm predict place n'accepte pas du tout ce flag ; il requiert --price, le prix de remplissage le plus défavorable par part qu'un trader acceptera, sur une échelle de 0 à 1. Ils se ressemblent et tous deux influencent le coût, mais l'un est une entrée de prévisualisation uniquement et l'autre est la limite d'exécution d'un ordre en direct — copier les flags d'un devis directement dans une commande place échouera plutôt que de faire silencieusement la même chose.

4. Ne remplacez la taille du tick que lorsque la valeur par défaut ne convient pas

mm predict quote et mm predict place acceptent tous deux --tick-size pour remplacer l'incrément de prix par défaut d'un marché. Les valeurs valides sont 0.1, 0.01, 0.005, 0.0025, 0.001 et 0.0001 ; omettre le flag utilise par défaut la taille de tick propre au CLOB pour ce token. Passer une valeur hors de cette liste renvoie INVALID_TICK_SIZE. Pour la plupart des marchés, la valeur par défaut est le bon choix — ce flag existe pour les cas où un trader a besoin d'une granularité de prix plus fine ou plus grossière que ce que la valeur par défaut du marché permet.

5. Adaptez le type d'ordre à l'urgence du remplissage

mm predict place utilise par défaut GTC (good-till-cancelled), qui reste dans le carnet jusqu'à être rempli ou annulé. GTD (good-till-date) requiert un timestamp --expiration. FOK (fill-or-kill) et FAK (fill-and-kill) exigent tous deux un remplissage immédiat — FOK en tout-ou-rien, FAK pour ce qui se remplit immédiatement avec le reste annulé — et aucun ne peut être combiné avec --post-only, qui rejette séparément tout ordre qui croiserait le carnet.

Un ordre FOK qui ne peut pas être entièrement rempli au prix demandé renvoie PREDICT_ORDER_NOT_FILLED, avec une suggestion d'ajuster --size ou --price, de vérifier le carnet, ou de passer à GTC. Une invite comme « achète ceci seulement si tu peux tout remplir maintenant » demande FOK ; « entre-moi dans cette position éventuellement, à ce prix ou mieux » demande GTC, et confondre les deux produit un ordre rejeté au lieu de la patience que le trader voulait réellement.

6. Vérifiez la liquidité et le géoblocage avant de calibrer une mise, pas après

mm predict book renvoie le carnet d'ordres pour un token, ce qui permet de voir si une taille donnée est réaliste avant de la passer — PREDICT_ORDER_SIZE_TOO_SMALL se déclenche lorsqu'une demande tombe en dessous du minimum de l'exchange, et son message d'aide renvoie à augmenter --size.

Par ailleurs, mm predict geoblock vérifie le statut de géoblocage de Polymarket pour l'IP du compte avant tout mouvement d'argent. Deux codes d'erreur reflètent cette application au niveau de Polymarket, et non au niveau du wallet : PREDICT_GEOBLOCKED lorsque la région est bloquée selon l'API de géoblocage, et PREDICT_UNAVAILABLE_FOR_LEGAL_REASONS lorsque Polymarket renvoie une restriction légale HTTP 451. Aucun des deux n'est une décision de politique MetaMask ni quelque chose que le Guard Mode ou le Beast Mode modifie — c'est la disponibilité régionale propre à Polymarket, exposée via le CLI.

7. Il n'y a pas de simulation à blanc — un devis est la prévisualisation la plus proche

Contrairement à mm perps open, qui accepte --dry-run pour valider un ordre sans le signer, mm predict place n'a pas de flag équivalent dans la référence des commandes. Ce qui se rapproche le plus d'une répétition d'ordre est mm predict quote, qui prévisualise le coût à un prix et une taille donnés sans toucher au carnet. C'est une vraie prévisualisation de la tarification, pas une simulation de si l'ordre serait rempli — un devis peut sembler correct et le marché peut quand même bouger avant que l'appel place réel arrive.

8. Le rachat est une étape séparée et explicite — et c'est la deuxième vraie transaction du workflow

Une position résolue et gagnante ne se convertit pas en solde utilisable en une seule étape. mm predict redeem list montre quelles positions résolues sont actuellement rachetables, et mm predict redeem --wait ou mm predict redeem --all --wait en réclame une ou toutes — mais cela ne fait que déplacer les gains en pUSD à l'intérieur du wallet de dépôt predict, pas vers le wallet principal du trader. PREDICT_REDEEM_NONE et PREDICT_REDEEM_NOT_FOUND sont les deux codes d'erreur à reconnaître ici : le premier signifie que rien n'est actuellement rachetable, et le second signifie que l'ID de condition spécifique passé n'est pas une cible de rachat valide — généralement un signe de vérifier à nouveau redeem list plutôt que de réessayer avec le même ID.

Transférer ces pUSD vers un solde utilisable est une étape supplémentaire et distincte : mm predict withdraw --amount . L'omettre après le rachat est une façon courante de croire qu'un pari a été « encaissé » alors que les gains sont encore dans le wallet predict. PREDICT_WITHDRAW_ZERO se déclenche sur un montant nul ou manquant, et PREDICT_WITHDRAW_INSUFFICIENT_BALANCE se déclenche lorsque le wallet predict ne détient pas assez de pUSD pour couvrir le retrait demandé.

Le rachat, comme le dépôt, se comporte comme une vraie transaction plutôt qu'une action hors chaîne sur le carnet d'ordres — il est documenté avec le même schéma de job --wait que mm predict setup et mm predict deposit, contrairement à mm predict place ou mm predict cancel, qui ne l'acceptent jamais. Traitez-le avec le même soin décrit au conseil 2.

9. Utilisez history et positions pour des usages différents, et adaptez le champ de tri à la requête

mm predict positions montre ce qui est actuellement ouvert. mm predict history est une vue distincte des positions fermées : elle affiche par défaut les positions fermées avec le pnl signé, et passer à --type trade ou --type redeem affiche à la place l'activité de remplissage ou de réclamation. --start et --end ne filtrent que lorsque --type est trade ou redeem — ils sont silencieusement inapplicables à la vue fermée par défaut. Les champs de tri sont également spécifiques au type : les positions fermées se trient par realizedpnl, title, price, avgprice ou timestamp, tandis que l'activité de trade et de rachat se trie par timestamp, tokens ou cash. Passer un champ de tri de la mauvaise liste renvoie PREDICT_HISTORY_INVALID_SORT_BY — une demande de « mes plus grandes victoires, triées par taille » doit préciser lequel de ces deux vocabulaires elle entend.

Ce que Agent Wallet ne fait pas pour les marchés de prédiction

Être clair sur les limites est plus utile que de laisser entendre un périmètre plus large.

mm predict n'est pas la fonctionnalité Predictions grand public de MetaMask sur Mobile — c'est une intégration distincte, pilotée par CLI, avec Polymarket, conçue pour les développeurs et les agents, avec ses propres commandes et son propre wallet de dépôt dédié. Un trader venant de l'application Mobile ne doit pas s'attendre à ce que les deux partagent des soldes, un historique ou des paramètres.

Agent Wallet ne contourne pas et ne remplace pas les restrictions régionales de Polymarket. Les vérifications de géoblocage et de disponibilité légale se produisent au niveau de Polymarket et s'appliquent de la même façon quel que soit le mode de wallet, le mode de trading ou la façon dont la demande est formulée.

Les gains ne sont pas rachetés automatiquement à la résolution. Une position résolue et gagnante reste rachetable jusqu'à ce que mm predict redeem soit exécuté — il n'y a pas de balayage en arrière-plan qui la réclame au nom du trader.

Il n'y a pas de copy-trading intégré, de mise en miroir de portefeuille ou de logique d'ordre personnalisée superposée à mm predict — chaque appel de commande est une action unique et explicite. Les traders souhaitant une logique permanente de ce type peuvent la construire comme un plugin, une fonctionnalité bêta qui permet à un package npm installé d'ajouter de nouvelles commandes au CLI sous des capacités soumises à consentement, mais c'est une voie à construire soi-même plutôt que quelque chose qu'Agent Wallet fournit nativement.