APIs mit x402 über MetaMask Agent Wallet bezahlen: 8 Tipps

Wenn eine API, ein Data Feed oder ein MCP-Tool deinem Agent mit 402 Payment Required antwortet, kann die MetaMask Agent Wallet die Zahlung in USDC übernehmen – ganz ohne Anmeldung oder API-Schlüssel. Der Agent liest das Angebot des Servers, zeigt dir Asset, Betrag, Netzwerk und Empfänger an und signiert eine einmalige Zahlungsautorisierung, nachdem du sie bestätigt hast. Der Private Key bleibt in der Wallet. Die Signaturanfrage durchläuft außerdem den Threat-Scan des Wallet-Dienstes.

Haftungsausschluss: Dieser Leitfaden dient ausschließlich Bildungszwecken. Er stellt weder eine Finanzberatung noch eine Aufforderung zum Kauf dar und richtet sich nicht an Personen im Vereinigten Königreich. Krypto-Zahlungen durch KI-Agenten sind riskant und nicht für alle Nutzer geeignet.

Dies ist ein praktischer Leitfaden für Zahlungen mit x402 über die Agent Wallet. Was x402 ist, wie der 402-Handshake funktioniert und wer das Protokoll steuert, erfährst du unter Was ist x402?. Entwickler, die delegationsbasierte x402-Zahlungen in ihre eigenen Apps einbauen, beginnen stattdessen am besten mit den x402-Leitfäden des Smart Accounts Kit. Wenn die Agent Wallet noch nicht eingerichtet ist, starte mit dem Schnellstart.

Warum Agenten pro Aufruf bezahlen, statt API-Schlüssel zu speichern

Eine kostenpflichtige API bedeutet meist ein Konto und einen langlebigen API-Schlüssel. Bei einem KI-Agenten muss dieser Schlüssel irgendwo liegen, wo der Agent ihn lesen kann – und genau das macht ihn zum Angriffsziel. In einer am 5. Februar 2026 veröffentlichten Studie hat Snyk 3.984 Skills auf dem ClawHub-Marktplatz untersucht und 283 Skills (etwa 7,1 %) gefunden, die API-Schlüssel, Passwörter oder Kartennummern durch das Kontextfenster des Modells oder in unverschlüsselte Speicherdateien geleitet haben, aus denen eine Prompt Injection sie wieder herausholen kann.

x402 beseitigt das dauerhafte Geheimnis. Der Agent zahlt pro Anfrage mit einer signierten Autorisierung für einen exakten Betrag an einen bestimmten Empfänger, die nur kurze Zeit gültig ist. Mit der Agent Wallet stammt diese Signatur vom Wallet-Dienst über mm wallet sign-typed-data, sodass der Agent weder einen Private Key noch einen API-Schlüssel in die Hand bekommt. Jede Autorisierung enthält eine zufällige Nonce, sodass sie nicht zweimal abgewickelt werden kann. Ein umfassenderer Blick darauf, was x402 für den Agent-Commerce verändert – einschließlich Agenten, die Dienste an andere Agenten verkaufen –, folgt in einem weiteren Beitrag.

Die x402-Oberfläche im Überblick

Die x402-Unterstützung wird als Python-Hilfsskript im Skill metamask-agent-wallet mitgeliefert, nicht als mm-Unterbefehl. Dein Agent ruft es auf, wenn eine Anfrage 402 zurückgibt. Normalerweise formulierst du einfach in normaler Sprache („Hol dir die Premium-Daten von dieser URL und zahle, falls 402 zurückkommt“), und der Agent führt diese Schritte für dich aus.

Die vollständige Referenz findest du im Leitfaden zu x402-Zahlungen und in der x402-Referenz des Skills.

Mit diesem Ablauf im Hinterkopf folgen hier 9 Tipps für x402-Zahlungen über die Agent Wallet.

1. USDC in dem Netzwerk bereithalten, das der Dienst verlangt

Der Server entscheidet, welche Assets und Netzwerke er akzeptiert. Der Agent kann nur eine Option bezahlen, die der Server anbietet.

Die Agent Wallet bezahlt nur EVM-Angebote, und zwar in Netzwerken, die in mm chains list enthalten sind. Guthaben werden pro Chain geführt, daher deckt USDC auf Ethereum kein Angebot auf Base ab. Wenn du USDC auf einer anderen Chain hast, kannst du den Agent auch bitten, Guthaben auf die benötigte Chain zu verschieben. Die Zahlung selbst ist eine gasfreie Offchain-Autorisierung. Der Facilitator des Dienstes wickelt sie onchain ab, daher braucht deine Wallet keine nativen Token, um Netzwerkgebühren für die Zahlung zu decken.

2. Das Angebot vor der Zahlung prüfen

inspect liest die 402-Antwort, ohne zu signieren oder Geld auszugeben. Es gibt das Asset, einen gut lesbaren Betrag, das Netzwerk, den Empfänger payTo und die Ressource zurück. Der Skill weist den Agent an, dir diese Details anzuzeigen und auf deine Bestätigung zu warten, bevor er pay ausführt, und pay verweigert die Ausführung ohne --confirm.

Bevor etwas signiert wird, laufen mehrere Prüfungen. Die Ressourcen-URL muss mit https:// beginnen. Das Skript folgt keinen Weiterleitungen, sodass eine hostübergreifende Weiterleitung eine Zahlung nicht an einen Server umleiten kann, den du nicht gewählt hast. Der Betrag muss eine positive ganze Zahl in der kleinsten Einheit des Tokens sein, und Empfänger und Asset müssen gültige Adressen sein. Beim exact-Schema entspricht der signierte Betrag dem angebotenen Betrag. Er ist keine Obergrenze, bis zu der der Server abbuchen darf.

3. Für jede Zahlung standardmäßig eine Bestätigung festlegen

Der Agent-Wallet-Skill kann den Agenten anweisen, vor jeder x402-Zahlung standardmäßig Asset, Betrag, Netzwerk, Empfänger und Ressource mit dir zu bestätigen. Die Bestätigung findet in deiner Unterhaltung mit dem Agenten statt. Sie ist unabhängig von der 2FA, die der Wallet-Dienst nur auslöst, wenn eine Anfrage markiert wird oder außerhalb deiner Richtlinie liegt.

Das passt zu einem Agenten, der in einer Sitzung einen Recherchebericht, ein paar Datenabrufe oder eine Geschenkkarte kauft. Für eine Schleife, die alle paar Sekunden einen kostenpflichtigen Endpunkt aufruft, eignet es sich schlecht, denn jeder Aufruf wartet auf dich. Bei einem mehrstufigen Kauf, der in mehreren Schritten Gebühren verursacht, wird bei jedem Schritt nachgefragt.

4. Wissen, was Guard Mode bei einer x402-Zahlung prüft

Im Server-Wallet-Modus geht jede Signaturanfrage an den Wallet-Dienst, der vor dem Signieren eine Bedrohungsprüfung durchführt. Eine markierte Anfrage pausiert in AWAITING_MFA, bis du sie genehmigst. x402-Autorisierungen haben ein kurzes Gültigkeitsfenster, das der Server festlegt. Wenn Guard Mode die Signatur für die 2FA anhält und du erst nach Ablauf des Fensters genehmigst, verfällt die Autorisierung ungenutzt. Lass den Agenten pay erneut ausführen. Dabei wird ein neuer 402 abgerufen und mit neuen Werten signiert. Genehmigungen erreichen dich dort, wohin deine Anmeldemethode sie sendet: per E-Mail-Link bei der Anmeldung mit Google oder E-Mail oder über das Benachrichtigungsmenü in MetaMask Mobile bei der Anmeldung per QR-Code.

Das rollierende 24-Stunden-Abflusslimit funktioniert hier anders. Die Abflussrichtlinie erfasst Token-Transfers, Swaps und Einzahlungen und legt seit dem 27. Oktober 2026 fest, dass Signaturen, etwa für Permit2, nicht in die Abflussberechnung einfließen. Eine x402-Autorisierung ist eine Signatur, daher ist das 24-Stunden-Limit keine verlässliche Obergrenze für x402-Ausgaben. Der Bestätigungsschritt hängt davon ab, dass der Agent den Skill befolgt, und die harte Obergrenze ist das Token-Guthaben in der zahlenden Wallet. Eine Möglichkeit, das Risiko zu begrenzen, ist eine separate Wallet, die nur für kostenpflichtige API-Aufrufe aufgeladen wird. Mit mm wallet create und mm wallet select verwaltest du mehrere Wallets.

5. Eine Option auswählen, wenn der Server mehrere anbietet

Wenn ein 402 dasselbe Schema für mehr als ein unterstütztes Netzwerk oder Asset auflistet, bricht das Skript mit dem Fehler „multiple eligible options“ ab, statt für dich zu wählen. Ein Dienst, der USDC sowohl auf Base als auch auf Monad akzeptiert, kann das auslösen. Führe den Befehl erneut mit --network (zum Beispiel eip155:8453 für Base) oder mit --asset und dem Token-Contract aus. Sag dem Agenten, auf welchem Netzwerk du Guthaben hast, dann kann er das Flag gleich beim ersten Versuch übergeben.

6. Prüfen, ob Agent Wallet das Angebot signieren kann

Der Helper signiert das exact-Schema mit EIP-3009 transferWithAuthorization auf EVM-Netzwerken, für x402-Protokoll v1 und v2. Er gibt eine klare Fehlermeldung zurück und signiert nichts, wenn er Folgendes sieht:

Wenn ein Dienst für dasselbe Asset sowohl Permit2 als auch EIP-3009 anbietet, wird die EIP-3009-Option verwendet. Auf der Seite zur Fehlerbehebung findest du jeden Fehler aufgelistet.

7. Eine Zahlung nicht blind erneut ausführen

Das Skript speichert keine vergangenen Zahlungen. Die EIP-3009-Nonce verhindert zwar, dass dieselbe signierte Autorisierung zweimal abgewickelt wird, aber jeder neue pay-Lauf erzeugt eine neue Zahlung. Wenn pay „payment not accepted“ zurückgibt, prüfe die Settlement-Ausgabe und ob das Autorisierungsfenster abgelaufen ist, bevor du es erneut versuchst. Ein zweiter Lauf für dieselbe Ressource bedeutet eine zweite Abbuchung, und der x402-Leitfaden weist Aufrufer an, sich gegen wiederholte Aufrufe abzusichern.

8. Auch für MCP-Tools und POST-Endpunkte bezahlen

x402 ist nicht auf GET-Anfragen beschränkt. Übergib --method und --data, dann sendet der Helper denselben Anfragetext mit angehängter Zahlung erneut, sodass ein kostenpflichtiger POST (zum Beispiel ein Endpunkt für KI-Chat-Completions) funktioniert wie ein kostenpflichtiger Download.

Kostenpflichtige MCP-Tools nutzen den MCP-Transport von x402 v2. Ein unbezahlter Tool-Aufruf liefert ein Fehlerergebnis mit der Zahlungs-Challenge zurück. Der Agent führt mcp-inspect aus, zeigt dir das Angebot, führt nach deiner Genehmigung mcp-sign --confirm aus und wiederholt den Tool-Aufruf mit der signierten Payload in _meta["x402/payment"]. Das Skript signiert, spricht aber kein MCP, daher übermittelt die eigene MCP-Sitzung des Agenten die Wiederholung. Wenn bei der Wiederholung erneut eine Challenge zurückkommt, wurde die Zahlung nicht abgewickelt, und der Agent meldet es dir, statt erneut zu signieren.

Was Agenten über x402 kaufen

Ein Anwendungsfall sind kostenpflichtige Daten: Ein Trading-Agent kann Signale oder Recherchen abrufen, bevor er handelt, und dann für die Ausführung an Swaps oder Perps übergeben. Einige Dienste, die x402 akzeptieren, mit Angaben aus der jeweiligen eigenen Dokumentation, Stand 27. Oktober 2026:

Jeder Service legt sein eigenes Angebotsformat fest. Lass den Agent daher zuerst inspect ausführen, um zu prüfen, ob das Angebot von Agent Wallet signiert werden kann (Tipp 6). Die x402-Endpunkte von Nansen akzeptieren zum Beispiel POST-Anfragen und nur x402 v2. Eine Beispielanfrage: „Hole die Smart-Money-Nettozuflüsse von Nansen für Ethereum. Wenn 402 zurückgegeben wird, zeige mir die Kosten und zahle, nachdem ich bestätigt habe.“ Um weitere x402-Services zu entdecken, ist x402scan ein Explorer für das x402-Ökosystem.

Was Agent Wallet bei x402 nicht leistet

• x402-Ausgaben mit dem Outflow-Limit begrenzen. Die Outflow-Richtlinie schließt Signaturen vorerst von der 24-Stunden-Berechnung aus.

• Jedes x402-Angebot signieren. Angebote, die nur Permit2 nutzen, upto-Angebote und Nicht-EVM-Angebote werden abgelehnt.

• Zahlungen deduplizieren. Es gibt noch kein Zahlungsprotokoll. Wenn du pay erneut ausführst, wird erneut gezahlt.

• Über x402 verkaufen. Der Helper funktioniert nur auf der Käuferseite. Einen kostenpflichtigen Endpunkt für andere Agents bereitzustellen, erfordert ein separates Setup.

• Als mm-Befehl ausführen. Es ist ein Python-3-Skript im Skill. Es gibt immer JSON aus, daher gelten --toon und --format nicht.