MetaMask Agent Walletで予測市場をトレードする方法：9つのトップヒント

MetaMask Agent Walletは、mm predict コマンドセットを通じて、Polymarketの予測市場での取引を行います。トレーダーは自然な言葉でエージェントにオッズの確認、ベット額の設定、または当選金の請求・出金を依頼でき、エージェントはそのリクエストを適切なコマンドに振り分けます。具体的には、専用のデポジットウォレットへの資金供給、注文の見積もり、注文の実行、解決後の償還、そして収益の出金が行われます。

Agent Walletでのパーペチュアル先物取引と同様に、スワップとは異なり、中間ステップがオフチェーンで処理されます。予測市場の場合、注文の実行とキャンセルはPolymarketの中央指値注文板（CLOB）に対してオフチェーンで行われる一方、デポジットウォレットへの資金供給と解決済みの当選金の請求は、MetaMaskが評価する実際のトランザクションとして処理されます。

この分離は、単一のプロンプトでは見落としやすい点です。「Fedの利下げに20ドルをベットして」というリクエストには、価格、注文タイプ、その価格をどの程度厳密に維持する必要があるかといった前提が含まれていません。UIを操作する場合は別々の画面として表示されるこれらの前提が、一文のリクエストに集約されてしまいます。本記事では、エージェントがそのリクエストを実行する前に明確にしておくべき詳細を解説します。

これはトレードの仕組みに関するガイドであり、予測市場の入門書ではありません。予測市場の概要や価格が確率をどのように反映するかについては、Polymarketとはをご覧ください。注文板、スプレッド、流動性、解決の仕組みについては、予測市場の基本概念と予測市場の価格設定の仕組みをご覧ください。ウォレットカテゴリ自体については、エージェンティックウォレットとはとエージェンティックウォレットの仕組みをご覧ください。異なるアセットクラスにおける同様のデポジットと注文の区別については、MetaMask Agent Walletを使ったパーペチュアル取引の方法とトークンのスワップおよびブリッジの方法をご覧ください。

事前に明確にしておくべき重要な点として、mm predictはAgent Wallet CLIが独自に構築したPolymarket統合であり、開発者とエージェント向けに設計されています。これは、MetaMask Mobileに組み込まれたコンシューマー向け機能であるMetaMask Predictionsとは別製品です。どちらもPolymarketで取引しますが、異なるインターフェースと異なるコマンドを持っており、本記事ではCLIのみを対象としています。

予測市場インターフェースの詳細

以下は、予測市場のワークフローで使用するコマンドです。インターフェースを理解することで、意図した通りに機能するリクエストを適切に表現しやすくなります。

出典：MetaMask Agent Walletコマンドリファレンス

以上の基本的な理解を踏まえ、MetaMask Agent Walletで予測市場取引を行うための9つのヒントをご紹介します。

1. セットアップは一度だけ実行し、スポット残高とは別のウォレットに資金を供給する

予測市場の取引は、メインウォレットの残高ではなく、専用の予測デポジットウォレットを通じて行われます。初回フローはmm predict setup --waitを実行し、続いてmm predict deposit --amount --waitを実行します。これにより、ウォレット内のPolygon USDC.eがそのデポジットウォレット内のpUSDに変換されます。デポジット前にセットアップをスキップすると、明確なエラーコードではなくJsonRpcError: execution revertedが表示される場合があります。

認識しておくべき2つの関連する障害モードがあります。PREDICT_INSUFFICIENT_GASはデポジットトランザクションのガス代をカバーするためにウォレットにPolygonのネイティブPOLが必要であることを意味し、PREDICT_INSUFFICIENT_ALLOWANCEはデポジットまたは注文を実行する前にmm predict approveでトークンの許可を修正する必要があることを意味します。どちらも1つのコマンドで解決できますが、正確に特定されて初めて対処できます。

ジオブロッキングも、注文が一件も実行される前のこの段階で最も発生しやすいです。アカウントの地域が制限されている場合、通常は注文ステップではなくsetupまたはdepositの段階でエラーとして表示されます。資金を供給する前に（後ではなく）mm predict geoblockを確認してください（詳細はヒント6参照）。また、nullの結果を問題なしと判断しないでください。ジオブロックチェックは制限されたアカウントに対してnullを返すことがあり、エージェントは現時点では明示的なクリアと確実に区別できません（運用上は同じ意味を持ちます）。結果が不明確な場合は、別途確認が取れるまでブロックされているものとして扱ってください。

2. Guard Modeの監視対象外となるのは、デポジットや償還ではなく注文であることを理解する

これはAgent Walletでのパーペチュアル先物取引と同じパターンであり、スワップのパターンとは異なります。ただし予測市場では、一方の端だけでなく中間ステップがオフチェーンとなります。MetaMaskのアウトフローポリシーでは、「デポジット（例：Uniswap、Polymarket、Hyperliquidへのデポジット）」が24時間のローリングアウトフロー制限の対象としてカウントされると明記されており、HyperliquidとともにPolymarketが名指しされています。つまり、予測デポジットウォレットへの資金供給トランザクションが、Guard Modeのアウトフロー制限、許可リスト、二要素認証の評価対象となります。mm predict placeとmm predict cancelはPolymarketの注文板に対する同期呼び出しであり、EVMトランザクションではないため、サイズに関わらずこれらのガードレールによるチェックは行われません。

償還については別途説明が必要です。mm predict redeemは--wait付きでドキュメント化されており、mm predict setupやmm predict depositと同じジョブベースのパターンを使用しています。アーキテクチャページでは、これをシミュレーション、脅威スキャン、ポリシー評価を経る署名またはトランザクションリクエストの特徴として説明しています。これは、解決済みポジションの請求が、注文の実行やキャンセルのようなオフチェーンの注文板アクションではなく、実際のオンチェーントランザクションであることを強く示しています。そのため、償還ステップはデポジットと同様の注意を払って扱い、注文と同じように扱わないでください。

脅威スキャンは、アウトフロー制限のようにレグによって分割されない唯一のガードレールです。取引モードの比較によると、Guard ModeとBeast Modeの両方に適用されます（アウトフロー制限と許可リストはGuard Modeのみ）。これはサーバーウォレットモードに適用されます。取引モードはBYOW（Bring Your Own Wallet）セットアップには適用されません。実用的な観点から言えば、単一の注文をサイジングするトレーダーは注文実行時にアウトフロー制限を意識する必要はありませんが、デポジットウォレットへの資金供給と当選金の償還の2つの場面では、引き続きその規律が適用されます。

3. --limit-priceはプレビュー用、--priceは注文実行用—互換性はない

mm predict quoteはオプションの--limit-priceを受け付け、特定の価格でのコストをプレビューします。mm predict placeはこのフラグを受け付けず、代わりに--price（トレーダーが受け入れる1株あたりの最悪の約定価格、0から1のスケール）が必要です。見た目は似ており、どちらもコストに影響しますが、一方はプレビュー専用の入力であり、もう一方はライブ注文の実行境界です。見積もりのフラグをそのまま注文コマンドにコピーすると、同じ処理が行われるのではなく、エラーが発生します。

4. デフォルトが適切でない場合のみティックサイズを上書きする

mm predict quoteとmm predict placeはどちらも--tick-sizeを受け付け、市場のデフォルト価格刻みを上書きできます。有効な値は0.1、0.01、0.005、0.0025、0.001、0.0001で、フラグを省略するとそのトークンのCLOB独自のティックサイズがデフォルトとなります。このリスト以外の値を渡すとINVALID_TICK_SIZEが返されます。ほとんどの市場ではデフォルトが適切な選択です。このフラグは、市場のデフォルトよりも細かいまたは粗い価格粒度が必要な場合のために存在します。

5. 約定の緊急度に合わせて注文タイプを選択する

mm predict placeはデフォルトでGTC（Good-Till-Cancelled：約定またはキャンセルまで有効）を使用し、約定またはキャンセルされるまで注文板に残ります。GTD（Good-Till-Date：指定日時まで有効）には--expirationタイムスタンプが必要です。FOK（Fill-Or-Kill：即時全量約定またはキャンセル）とFAK（Fill-And-Kill：即時約定可能分を約定し残りをキャンセル）はどちらも即時約定を要求します。FOKは全量約定またはキャンセル、FAKは即時約定可能分を約定して残りをキャンセルします。どちらも--post-onlyと組み合わせることはできません。--post-onlyは注文板をクロスする注文を拒否します。

指定価格で全量約定できないFOK注文はPREDICT_ORDER_NOT_FILLEDを返し、--sizeまたは--priceの調整、注文板の確認、またはGTCへの切り替えを提案します。「今すぐ全量約定できる場合のみ購入して」というプロンプトはFOKを求めており、「この価格以下でいつかこのポジションに入って」はGTCを求めています。この2つを混同すると、トレーダーが本来望んでいた忍耐強い注文ではなく、拒否された注文が生まれます。

6. ベット額を決める前に、後ではなく、流動性とジオブロッキングを確認する

mm predict bookはトークンの注文板を返します。これは、注文を実行する前に特定のサイズが現実的かどうかを確認する方法です。リクエストが取引所の最小値を下回るとPREDICT_ORDER_SIZE_TOO_SMALLが発生し、そのヒントは--sizeの引き上げを指示します。

また、mm predict geoblockは資金移動前にアカウントのIPに対するPolymarketのジオブロックステータスを確認します。このチェックはPolymarketレイヤーで行われるものであり、ウォレットレイヤーではありません。2つのエラーコードがこの強制を反映しています。PREDICT_GEOBLOCKEDはジオブロックAPIによって地域がブロックされている場合、PREDICT_UNAVAILABLE_FOR_LEGAL_REASONSはPolymarketがHTTP 451法的制限を返す場合です。どちらもMetaMaskのポリシー決定ではなく、Guard ModeとBeast Modeで変わるものでもありません。CLIを通じて表示されるPolymarket独自の地域的な利用可能性です。

7. ドライランはない—見積もりが最も近いプレビュー

mm perps openが--dry-runを受け付けて署名なしで注文を検証できるのとは異なり、mm predict placeにはコマンドリファレンスに同等のフラグがありません。注文をリハーサルする最も近い方法はmm predict quoteであり、注文板に触れることなく特定の価格とサイズでのコストをプレビューします。これは価格の真のプレビューですが、注文が約定するかどうかのシミュレーションではありません。見積もりが正しく見えても、実際のplaceコールが届く前に市場が動く可能性があります。

8. 償還は別途明示的なステップが必要—ワークフローにおける2番目の実際のトランザクション

解決済みの当選ポジションは、1ステップで使用可能な残高に変換されるわけではありません。mm predict redeem listは現在償還可能な解決済みポジションを表示し、mm predict redeem --waitまたはmm predict redeem --all --waitで1つまたはすべてを請求できます。ただし、これにより当選金が予測デポジットウォレット内のpUSDに移動するだけで、トレーダーのメインウォレットには戻りません。ここで認識しておくべき2つのエラーコードがあります。PREDICT_REDEEM_NONEは現在償還可能なものがないことを意味し、PREDICT_REDEEM_NOT_FOUNDは渡された特定のコンディションIDが有効な償還ターゲットではないことを意味します。後者は通常、同じIDを再試行するのではなくredeem listを再確認するサインです。

そのpUSDを使用可能な残高として出金するには、さらに別のステップが必要です：mm predict withdraw --amount 。償還後にこのステップをスキップすると、当選金がまだ予測ウォレットに残っているにもかかわらず、ベットが「換金済み」だと思い込む一般的な誤りが生じます。PREDICT_WITHDRAW_ZEROはゼロまたは金額が未指定の場合に発生し、PREDICT_WITHDRAW_INSUFFICIENT_BALANCEは予測ウォレットが要求された出金額をカバーするのに十分なpUSDを保有していない場合に発生します。

償還はデポジットと同様に、オフチェーンの注文板アクションではなく実際のトランザクションとして動作します。mm predict placeやmm predict cancelとは異なり、mm predict setupやmm predict depositと同じ--waitジョブパターンでドキュメント化されています。ヒント2で説明したのと同様の注意を払って扱ってください。

9. 履歴とポジションは異なる目的に使用し、クエリに合ったソートフィールドを選択する

mm predict positionsは現在オープンなポジションを表示します。mm predict historyは別のクローズドビューです。デフォルトでは署名済みpnlを持つクローズドポジションを表示し、--type tradeまたは--type redeemに切り替えると約定またはクレームアクティビティが表示されます。--startと--endは--typeがtradeまたはredeemの場合のみフィルタリングが機能します。デフォルトのクローズドビューには適用されず、エラーなく無視されます。ソートフィールドもタイプ固有です。クローズドポジションはrealizedpnl、title、price、avgprice、またはtimestampでソートし、取引および償還アクティビティはtimestamp、tokens、またはcashでソートします。誤ったリストのソートフィールドを渡すとPREDICT_HISTORY_INVALID_SORT_BYが返されます。「最大の当選を規模順に表示して」というリクエストは、どちらの語彙を意味するかを指定する必要があります。

Agent Walletが予測市場に対して行わないこと

境界を明確にすることは、より広い範囲を示唆するよりも有用です。

mm predictはMobile上のMetaMaskのコンシューマー向けPredictions機能ではありません。独自のコマンドと専用のデポジットウォレットを持つ、開発者とエージェント向けに構築されたPolymarketとのCLI駆動の統合です。Mobileアプリから来たトレーダーは、両者が残高、履歴、または設定を共有することを期待すべきではありません。

Agent WalletはPolymarketの地域制限を回避または上書きしません。ジオブロッキングと法的利用可能性のチェックはPolymarketレイヤーで行われ、ウォレットモード、取引モード、またはリクエストの表現方法に関わらず同様に適用されます。

当選金は解決時に自動的に償還されません。解決済みの当選ポジションはmm predict redeemが実行されるまで償還可能な状態で残ります。トレーダーに代わって自動的に請求するバックグラウンド処理はありません。

mm predictの上にコピートレード、ポートフォリオミラーリング、またはカスタム注文ロジックは組み込まれていません。各コマンド呼び出しは単一の明示的なアクションです。そのような常設ロジックを求めるトレーダーはプラグインとして構築できます。これはベータ機能であり、インストールされたnpmパッケージが同意ゲート機能の下でCLIに新しいコマンドを追加できるようにするものですが、Agent Walletに付属するものではなく、自分で構築するパスです。