MetaMask Agent Wallet handelt Polymarket-Prognosemärkte über das mm predict-Befehlsset. Ein Trader bittet seinen Agenten in natürlicher Sprache darum, Quoten zu prüfen, einen Einsatz zu bemessen oder Gewinne einzulösen und auszuzahlen – der Agent leitet diese Anfrage dann an die entsprechenden Befehle weiter, die eine dedizierte Einzahlungs-Wallet befüllen, eine Order quotieren, platzieren, nach Auflösung einlösen und den Erlös auszahlen.
Ähnlich wie beim Handel mit unbefristeten Futures (Perpetual Futures) auf Agent Wallet – und anders als bei Swaps – ist der Zwischenschritt derjenige, der außerhalb der Bücher stattfindet: Das Platzieren und Stornieren einer Order läuft off-chain gegen Polymarkets Central Limit Order Book, während das Befüllen der Einzahlungs-Wallet und das Einlösen aufgelöster Gewinne die beiden Schritte sind, die sich wie echte Transaktionen verhalten und von MetaMask ausgewertet werden.
Diese Unterscheidung lässt sich in einem einzelnen Prompt leicht übersehen. „Setze 20 $ auf eine Zinssenkung der Fed" enthält unausgesprochene Annahmen über Preis, Ordertyp und wie fest dieser Preis gehalten werden muss – Annahmen, die eine klassische UI als separate Bildschirme anzeigen würde, die ein Satz jedoch zu einer einzigen Anfrage zusammenfasst. Dieser Artikel behandelt die Details, die es wert sind, explizit gemacht zu werden, bevor ein Agent auf diesen Satz reagiert.
Dies ist ein Leitfaden zur Handelsmechanik, keine Einführung in Prognosemärkte. Was Prognosemärkte sind und wie Preise Wahrscheinlichkeiten widerspiegeln, erklärt was ist Polymarket. Orderbücher, Spreads, Liquidität und Auflösungsmechanismen werden in grundlegende Konzepte für Prognosemärkte und wie die Preisgestaltung auf Prognosemärkten funktioniert behandelt. Zur Wallet-Kategorie selbst siehe was ist eine agentische Wallet und wie agentische Wallets funktionieren. Für dieselbe Unterscheidung zwischen Einzahlung und Order in einer anderen Anlageklasse siehe wie man Perps handelt und wie man Token swappt und bridget mit MetaMask Agent Wallet.
Eine Unterscheidung, die vorab erwähnt werden sollte: mm predict ist die eigene Polymarket-Integration des Agent Wallet CLI, entwickelt für Entwickler und Agenten. Es handelt sich um ein separates Produkt von MetaMask Predictions, dem verbraucherorientierten Feature, das in MetaMask Mobile integriert ist. Beide handeln auf Polymarket, sind jedoch unterschiedliche Oberflächen mit unterschiedlichen Befehlen – dieser Artikel behandelt ausschließlich das CLI.
Die Prognosemarkt-Oberfläche im Überblick
Dies sind die Befehle, auf die ein Prognosemarkt-Workflow zurückgreift. Wer die Oberfläche kennt, kann Anfragen präziser formulieren, sodass sie wie beabsichtigt ankommen.
Was du deinen Agenten fragst | Was ausgeführt wird | Was es tut |
„Richte mich für den Handel mit Prognosemärkten ein" | mm predict setup --wait
| Einmalige Einrichtung der dedizierten Predict-Einzahlungs-Wallet |
„Lege 50 $ in meine Prognosemarkt-Wallet" | mm predict deposit --amount 50 --wait
| Wandelt Polygon USDC.e in deiner Wallet in pUSD in der Predict-Einzahlungs-Wallet um |
„Finde Märkte zur nächsten Fed-Zinsentscheidung" | mm predict markets search ""
| Durchsucht Polymarket-Märkte nach Stichwörtern |
„Was würden 20 YES-Shares auf diesem Markt kosten?" | mm predict quote --token-id --side buy --size 20
| Zeigt Orderkosten als Vorschau, ohne sie zu platzieren |
„Setze 10 USDC auf YES zu 62 Cent" | mm predict place --token-id --side buy --size 10 --price 0.62
| Platziert eine Live-Order im Orderbuch von Polymarket |
„Zeige meine offenen Prognosemarkt-Positionen" | mm predict positions
| Listet aktuelle Bestände auf |
„Löse meine Gewinneinsätze ein" | mm predict redeem --all --wait
| Beansprucht Auszahlungen für aufgelöste Gewinnerpositionen |
„Übertrage meine Gewinne zurück in meine Wallet" | mm predict withdraw --amount
| Hebt pUSD aus der Predict-Einzahlungs-Wallet ab |
Quelle: MetaMask Agent Wallet-Befehlsreferenz.
Mit diesem grundlegenden Verständnis folgen nun 9 Tipps für die Nutzung von MetaMask Agent Wallet zum Handel auf Prognosemärkten.
1. Setup einmal ausführen, dann eine Wallet befüllen, die vom Spot-Guthaben getrennt ist
Der Handel auf Prognosemärkten läuft über eine dedizierte Predict-Einzahlungs-Wallet, nicht über dein Haupt-Wallet-Guthaben. Der Ersteinrichtungsablauf ist mm predict setup --wait, gefolgt von mm predict deposit --amount --wait, wodurch Polygon USDC.e in deiner Wallet in pUSD innerhalb dieser Einzahlungs-Wallet umgewandelt wird. Wenn das Setup vor der Einzahlung übersprungen wird, kann ein nichtssagender JsonRpcError: execution reverted auftreten, anstatt eines klaren Fehlercodes.
Zwei verwandte Fehlermodi, die es zu kennen gilt: PREDICT_INSUFFICIENT_GAS bedeutet, dass die Wallet natives POL auf Polygon benötigt, um die Gas-Kosten der Einzahlungstransaktion zu decken, und PREDICT_INSUFFICIENT_ALLOWANCE bedeutet, dass die Token-Allowance mit mm predict approve repariert werden muss, bevor eine Einzahlung oder Order durchgeführt werden kann. Beide sind mit einem einzigen Befehl lösbar – aber erst, wenn sie korrekt identifiziert wurden.
Geoblocking tritt am wahrscheinlichsten genau hier auf, noch bevor eine einzige Order platziert wird – wenn die Region des Kontos gesperrt ist, zeigt sich das typischerweise bei setup oder deposit als Fehler, nicht erst beim Order-Schritt. Prüfe mm predict geoblock vor der Befüllung, nicht danach (mehr dazu in Tipp 6), und behandle ein null-Ergebnis nicht als Unbedenklichkeitsbescheinigung: Die Geoblock-Prüfung kann für ein gesperrtes Konto null zurückgeben, und der Agent unterscheidet das heute nicht zuverlässig von einer expliziten Freigabe, auch wenn es operativ dasselbe bedeutet. Behandle ein unklares Ergebnis genauso wie ein gesperrtes, bis das Gegenteil bestätigt ist.
2. Wissen, dass die Order – nicht die Einzahlung oder die Einlösung – außerhalb des Guard Mode-Radars bleibt
Dies entspricht demselben Muster wie der Handel mit Perpetual Futures auf Agent Wallet, nicht dem Muster von Swaps – bei Prognosemärkten ist jedoch der mittlere Schritt off-chain, nicht nur ein Ende. MetaMasks Outflow-Richtlinie nennt „Einzahlungen (z. B. bei Uniswap, Polymarket oder Hyperliquid)" als das, was auf das rollende 24-Stunden-Outflow-Limit angerechnet wird – Polymarket wird namentlich erwähnt, genauso wie Hyperliquid. Das bedeutet, dass die Finanzierungstransaktion in die Predict-Einzahlungs-Wallet das ist, was Guard Modes Outflow-Limit, Allowlists und Zwei-Faktor-Authentifizierung auswerten. mm predict place und mm predict cancel sind synchrone Aufrufe gegen Polymarkets Orderbuch, keine EVM-Transaktionen – sie werden daher unabhängig von der Größe nicht gegen diese Sicherheitsmechanismen geprüft.
Die Einlösung verdient eine gesonderte Erwähnung: mm predict redeem ist mit --wait dokumentiert, demselben jobbasierten Muster wie mm predict setup und mm predict deposit, das die Architektur-Seite als Merkmal einer Signing- oder Transaktionsanfrage beschreibt, die Simulation, Bedrohungsscan und Richtlinienauswertung durchläuft. Das ist ein starkes Signal dafür, dass das Einlösen einer aufgelösten Position eine echte Onchain-Transaktion ist, keine off-chain Orderbuch-Aktion wie das Platzieren oder Stornieren – behandle den Einlösungsschritt daher mit derselben Sorgfalt wie die Einzahlung, nicht wie eine Order.
Der Bedrohungsscan ist der einzige Schutzmechanismus, der sich nicht nach Schritt aufteilt wie das Outflow-Limit: Er gilt sowohl im Guard Mode als auch im Beast Mode, gemäß dem Handelsmodi-Vergleich – nur das Outflow-Limit und die Allowlists sind Guard-Mode-exklusiv. Dies gilt für den Server-Wallet-Modus; Handelsmodi gelten nicht für Bring-your-own-Wallet-Setups. Die praktische Konsequenz: Ein Trader, der eine einzelne Order bemisst, muss beim Platzieren nicht an das Outflow-Limit denken – aber das Befüllen der Einzahlungs-Wallet und später das Einlösen eines Gewinns sind die zwei Momente, bei denen diese Disziplin weiterhin gilt.
3. --limit-price für Vorschauen, --price zum Platzieren – sie sind nicht austauschbar
mm predict quote akzeptiert ein optionales --limit-price, um die Kosten zu einem bestimmten Preis als Vorschau anzuzeigen. mm predict place akzeptiert dieses Flag überhaupt nicht; es erfordert --price, den schlechtesten akzeptierten Ausführungspreis pro Share, auf einer Skala von 0 bis 1. Beide sehen ähnlich aus und beeinflussen beide die Kosten, aber eines ist ein reiner Vorschau-Input und das andere ist die Ausführungsgrenze einer Live-Order – das direkte Kopieren der Flags eines Quotes in einen Place-Befehl schlägt fehl, anstatt stillschweigend dasselbe zu tun.
4. Die Tick-Größe nur überschreiben, wenn der Standard nicht passt
Sowohl mm predict quote als auch mm predict place akzeptieren --tick-size, um das Standard-Preisinkrement eines Marktes zu überschreiben. Gültige Werte sind 0.1, 0.01, 0.005, 0.0025, 0.001 und 0.0001; wird das Flag weggelassen, wird die eigene Tick-Größe des CLOB für diesen Token verwendet. Die Angabe eines Werts außerhalb dieser Liste gibt INVALID_TICK_SIZE zurück. Für die meisten Märkte ist der Standard die richtige Wahl – dieses Flag existiert für Fälle, in denen ein Trader eine feinere oder gröbere Preisgranularität benötigt, als der Marktstandard erlaubt.
5. Den Ordertyp danach wählen, wie dringend eine Ausführung jetzt erfolgen muss
mm predict place verwendet standardmäßig GTC (good-till-cancelled), das im Buch verbleibt, bis es ausgeführt oder storniert wird. GTD (good-till-date) erfordert einen --expiration-Zeitstempel. FOK (fill-or-kill) und FAK (fill-and-kill) verlangen beide eine sofortige Ausführung – FOK alles-oder-nichts, FAK für alles, was sofort ausgeführt wird, mit Stornierung des Rests – und keiner von beiden kann mit --post-only kombiniert werden, das eine Order separat ablehnt, die das Buch überhaupt kreuzen würde.
Eine FOK-Order, die zum angeforderten Preis nicht vollständig ausgeführt werden kann, gibt PREDICT_ORDER_NOT_FILLED zurück, mit einem Hinweis, --size oder --price anzupassen, das Buch zu prüfen oder stattdessen zu GTC zu wechseln. Ein Prompt wie „kaufe das nur, wenn du die gesamte Menge sofort ausführen kannst" verlangt FOK; „bringe mich irgendwann in diese Position, zu diesem Preis oder besser" verlangt GTC – wer beides verwechselt, erhält eine abgelehnte Order statt der eigentlich gewünschten Geduld.
6. Liquidität und Geoblocking vor der Einsatzbemessung prüfen, nicht danach
mm predict book gibt das Orderbuch für einen Token zurück – so lässt sich prüfen, ob eine bestimmte Größe realistisch ist, bevor sie platziert wird. PREDICT_ORDER_SIZE_TOO_SMALL wird ausgelöst, wenn eine Anfrage unter das Exchange-Minimum fällt, und der Hinweis verweist darauf, --size zu erhöhen.
Separat prüft mm predict geoblock den Geoblock-Status von Polymarket für die IP des Kontos, bevor Geld bewegt wird. Zwei Fehlercodes spiegeln diese Durchsetzung auf der Polymarket-Ebene wider, nicht auf der Wallet-Ebene: PREDICT_GEOBLOCKED, wenn die Region gemäß der Geoblock-API gesperrt ist, und PREDICT_UNAVAILABLE_FOR_LEGAL_REASONS, wenn Polymarket einen HTTP 451 Legal Restriction zurückgibt. Keiner davon ist eine MetaMask-Richtlinienentscheidung oder wird durch Guard Mode versus Beast Mode beeinflusst – es handelt sich um Polymarkets eigene regionale Verfügbarkeit, die über das CLI angezeigt wird.
7. Es gibt keinen Testlauf – ein Quote ist die nächstmögliche Vorschau
Anders als mm perps open, das --dry-run akzeptiert, um eine Order ohne Signierung zu validieren, hat mm predict place kein entsprechendes Flag in der Befehlsreferenz. Das Nächste, was einer Probe-Order entspricht, ist mm predict quote, das Kosten bei einem bestimmten Preis und einer bestimmten Größe als Vorschau anzeigt, ohne das Buch zu berühren. Das ist eine echte Vorschau der Preisgestaltung, keine Simulation, ob die Order ausgeführt würde – ein Quote kann korrekt aussehen, und der Markt kann sich dennoch bewegen, bevor der eigentliche place-Aufruf eintrifft.
8. Die Einlösung ist ein separater, expliziter Schritt – und die zweite echte Transaktion im Workflow
Eine aufgelöste Gewinnposition wird nicht in einem Schritt in verfügbares Guthaben umgewandelt. mm predict redeem list zeigt, welche aufgelösten Positionen derzeit einlösbar sind, und mm predict redeem --wait oder mm predict redeem --all --wait beansprucht eine oder alle davon – aber das verschiebt die Gewinne nur in pUSD innerhalb der Predict-Einzahlungs-Wallet, nicht zurück in die Haupt-Wallet des Traders. PREDICT_REDEEM_NONE und PREDICT_REDEEM_NOT_FOUND sind die zwei Fehlercodes, die hier relevant sind: Der erste bedeutet, dass derzeit nichts einlösbar ist, und der zweite bedeutet, dass die angegebene Condition-ID kein gültiges Einlöseziel ist – in der Regel ein Zeichen dafür, redeem list erneut zu prüfen, anstatt dieselbe ID erneut zu versuchen.
Das pUSD auf verfügbares Guthaben auszuzahlen ist ein weiterer, separater Schritt: mm predict withdraw --amount . Diesen nach dem Einlösen zu überspringen ist ein häufiger Grund dafür, zu glauben, ein Einsatz sei „ausgezahlt", obwohl die Gewinne noch in der Predict-Wallet liegen. PREDICT_WITHDRAW_ZERO wird bei einem Betrag von null oder einem fehlenden Betrag ausgelöst, und PREDICT_WITHDRAW_INSUFFICIENT_BALANCE wird ausgelöst, wenn die Predict-Wallet nicht genug pUSD hält, um die angeforderte Auszahlung zu decken.
Die Einlösung verhält sich wie die Einzahlung als echte Transaktion, nicht als off-chain Orderbuch-Aktion – sie ist mit demselben --wait-Job-Muster wie mm predict setup und mm predict deposit dokumentiert, anders als mm predict place oder mm predict cancel, die es nie verwenden. Behandle sie mit derselben Sorgfalt wie in Tipp 2 beschrieben.
9. History und Positions für unterschiedliche Zwecke nutzen und das Sortierfeld zur Abfrage passend wählen
mm predict positions zeigt, was derzeit offen ist. mm predict history ist eine separate, abgeschlossene Ansicht: Sie zeigt standardmäßig geschlossene Positionen mit signiertem pnl, und der Wechsel zu --type trade oder --type redeem zeigt stattdessen Ausführungs- oder Einlöseaktivitäten an. --start und --end filtern nur, wenn --type trade oder redeem ist – sie sind für die standardmäßige geschlossene Ansicht stillschweigend nicht anwendbar. Sortierfelder sind ebenfalls typspezifisch: Geschlossene Positionen werden nach realizedpnl, title, price, avgprice oder timestamp sortiert, während Handels- und Einlöseaktivitäten nach timestamp, tokens oder cash sortiert werden. Die Angabe eines Sortierfelds aus der falschen Liste gibt PREDICT_HISTORY_INVALID_SORT_BY zurück – eine Anfrage nach „meinen größten Gewinnen, sortiert nach Größe" muss angeben, welches dieser beiden Vokabulare gemeint ist.
Was Agent Wallet für Prognosemärkte nicht tut
Eine klare Abgrenzung ist hilfreicher als die Andeutung eines größeren Funktionsumfangs.
mm predict ist nicht MetaMasks verbraucherorientiertes Predictions-Feature auf Mobile – es ist eine separate, CLI-gesteuerte Integration mit Polymarket, die für Entwickler und Agenten entwickelt wurde, mit eigenen Befehlen und einer eigenen dedizierten Einzahlungs-Wallet. Ein Trader, der von der Mobile-App kommt, sollte nicht erwarten, dass beide Guthaben, Verlauf oder Einstellungen teilen.
Agent Wallet umgeht oder überschreibt Polymarkets regionale Einschränkungen nicht. Geoblocking- und Rechtsverfügbarkeitsprüfungen finden auf der Polymarket-Ebene statt und gelten unabhängig von Wallet-Modus, Handelsmodus oder der Formulierung der Anfrage gleichermaßen.
Gewinne werden bei Auflösung nicht automatisch eingelöst. Eine aufgelöste Gewinnposition bleibt einlösbar, bis mm predict redeem ausgeführt wird – es gibt keinen Hintergrundprozess, der sie im Auftrag des Traders beansprucht.
Es gibt keine integrierte Copy-Trading-, Portfolio-Mirroring- oder benutzerdefinierte Order-Logik, die auf mm predict aufgesetzt ist – jeder Befehlsaufruf ist eine einzelne, explizite Aktion. Trader, die eine solche dauerhafte Logik wünschen, können sie als Plugin entwickeln, einem Beta-Feature, das es einem installierten npm-Paket ermöglicht, dem CLI unter zustimmungsgesteuerten Berechtigungen neue Befehle hinzuzufügen – aber das ist ein Selbstbau-Weg und kein mitgeliefertes Feature von Agent Wallet.
Nein. Beide werden auf Polymarket gehandelt, sind aber separate Produkte. MetaMask Predictions ist die Consumer-Funktion, die in MetaMask Mobile integriert ist; mm predict ist der eigene Befehlssatz des Agent Wallet CLI für Entwickler und Agenten – mit einer separaten Einzahlungs-Wallet und ohne gemeinsame Guthaben oder Verlauf mit der Mobile-Funktion.
Nein. Das Aufgeben und Stornieren einer Prediction-Market-Order erfolgt Off-Chain über das Orderbuch von Polymarket und wird daher weder gegen das Abflusslimit des Guard Mode noch gegen Allowlists oder 2FA geprüft. Die Einzahlung in das Deposit-Wallet ist die EVM-Transaktion, die diese Sicherheitsmechanismen bewerten – dasselbe Muster wie bei Perpetual Futures und das Gegenteil von Swaps, bei denen der Trade selbst die geprüfte Transaktion ist. Das Einlösen einer abgeschlossenen Position verhält sich eher wie eine echte zweite Transaktion als wie eine Orderbuch-Aktion (sie ist mit demselben --wait-Job-Muster wie die Einzahlung dokumentiert) und verdient daher dieselbe Sorgfalt – auch wenn sie selbst nicht dem Abflusslimit unterliegt, das den aus dem Wallet abfließenden Wert verfolgt und nicht eingehende Gewinne.
--limit-price ist ein reines Vorschau-Flag bei mm predict quote. mm predict place akzeptiert es überhaupt nicht; dort wird --price benötigt, also der schlechteste akzeptable Füllpreis pro Anteil für die Order. Es handelt sich nicht um austauschbare Flags, auch wenn beide die Kosten eines Trades beeinflussen.
GTC (die Standardeinstellung) bleibt im Orderbuch, bis es ausgeführt oder storniert wird, und eignet sich für Trader, die bereit sind, auf einen Preis zu warten. GTD fügt ein Ablaufdatum hinzu. FOK und FAK verlangen beide eine sofortige Ausführung und eignen sich für Trader, die den Trade nur dann durchführen möchten, wenn er sofort möglich ist. --post-only lehnt eine Order ab, die das Orderbuch kreuzen würde, und kann nicht mit FOK oder FAK kombiniert werden.
Führe mm predict geoblock aus, um die IP des Kontos gegen den Geoblock-Status von Polymarket zu prüfen, bevor du etwas einzahlst. PREDICT_GEOBLOCKED und PREDICT_UNAVAILABLE_FOR_LEGAL_REASONS spiegeln beide Einschränkungen wider, die auf der Polymarket-Ebene durchgesetzt werden, nicht eine MetaMask-Wallet-Einstellung.
Nein, und das Einlösen ist auch nicht der letzte Schritt. Eine abgeschlossene, gewinnende Position wird einlösbar, aber nicht automatisch beansprucht – führe mm predict redeem list aus, um zu sehen, was derzeit einlösbar ist, dann mm predict redeem <CONDITION_ID> --wait oder --all --wait, um sie zu beanspruchen. Dadurch wird die Position in pUSD im predict-Einzahlungs-Wallet umgewandelt, nicht als verfügbares Guthaben im Haupt-Wallet eines Traders. Um es dorthin zu übertragen, ist ein weiterer mm predict withdraw --amount <AMOUNT>-Aufruf erforderlich.
Ähnlich wie die Einzahlung. mm predict withdraw folgt demselben jobbasierten Muster wie mm predict setup, mm predict deposit und mm predict redeem – im Gegensatz zu mm predict place und mm predict cancel, die synchrone Aufrufe gegen das Polymarket-Orderbuch sind. PREDICT_WITHDRAW_ZERO und PREDICT_WITHDRAW_INSUFFICIENT_BALANCE sind die zwei dedizierten Fehlercodes.
Nicht direkt. mm predict place hat kein --dry-run-Äquivalent. mm predict quote ist die nächstgelegene verfügbare Vorschau – es berechnet den Preis einer Order bei einer bestimmten Größe und einem bestimmten Preis, ohne das Orderbuch zu berühren, simuliert jedoch nicht, ob die Order tatsächlich ausgeführt werden würde.