Clawy / Guides / Was ist x402

Was ist x402?

Ein offenes Protokoll, das "HTTP 402 Payment Required" — den 30 Jahre lang ungenutzten Statuscode — in echte Zahlungen verwandelt. Es lässt ein Programm einen API-Call mit Stablecoins bezahlen, ohne Konto und ohne API-Key.

Jede API heute sperrt den Zugang hinter einem API-Key, den du registrierst, speicherst und über einen Monatsplan abrechnest. Das funktioniert für Menschen, die durch ein Dashboard klicken. Für Software ist es Reibung — besonders für KI-Agenten, die einen Dienst einmal aufrufen, genau dafür zahlen und weiterziehen wollen. x402 entfernt das Konto komplett: Der Preis steht in der Antwort, und der Client zahlt pro Anfrage.

Der Ablauf in drei Schritten

Der Client ruft den Endpunkt ohne Zahlung auf. Der Server antwortet mit 402 Payment Required und nennt den Preis und wohin zu zahlen ist (in einem Header).

Der Client signiert eine Stablecoin-Zahlung über genau diesen Betrag — typischerweise USDC auf Base — mit einer EIP-3009-Autorisierung (eine Signatur, keine On-Chain-Transaktion vom Client).

Der Client wiederholt dieselbe Anfrage mit der signierten Zahlung in einem X-PAYMENT-Header. Ein Facilitator wickelt sie on-chain ab, der Server gibt 200 OK mit dem Ergebnis zurück.

POST /v1/chat/opus            -> 402  (PAYMENT-REQUIRED: amount=150000, payTo=0x...)
   sign EIP-3009 for 0.15 USDC
POST /v1/chat/opus + X-PAYMENT -> 200  { "choices": [ ... ] }

Warum es für KI-Agenten zählt

Keine Anmeldung, keine Key-Verwaltung. Ein Agent kann einen Dienst eigenständig entdecken und bezahlen, ohne dass zuerst ein Mensch ein Konto anlegt.
Zahle genau für das, was du nutzt. Ein Call, eine Micro-Zahlung — kein $20/Monat-Minimum für drei Anfragen.
Maschinenlesbare Discovery. x402-Dienste veröffentlichen Manifeste (`/.well-known/x402.json`, `/llms.txt`), damit Agenten sie programmatisch finden und Preise prüfen können.

Es ist früh — das Ökosystem zahlender Agenten bildet sich noch — aber es ist die sauberste Antwort auf "wie zahlt ein Programm einem anderen für einen einzelnen Call", die es heute gibt.

Häufige Fragen

Ist es bei jedem Call eine Blockchain-Transaktion? Der Client signiert nur; ein Facilitator bündelt/wickelt ab. Der Käufer braucht eine finanzierte Wallet, kein Gas pro Call.

Was kostet die Annahme? Du erhältst Stablecoins in deine Wallet; die Facilitator-Gebühren sind gering. Kein Payment-Processor-Konto, keine Monatsgebühr.

Welche Chains? Base Mainnet ist am verbreitetsten (USDC); Solana und andere werden von manchen Diensten unterstützt.

→ Ruf in 5 Minuten eine auf. Ein vollständiger Copy-paste-x402-Client (Node), der einen Live-Endpunkt aufruft, die Zahlung signiert und eine Antwort erhält — starte auf einer $0,04-Stufe.

Willst du selbst eine API mit Abrechnung pro Call verkaufen? Zwei Dinge entscheiden, ob sie Geld bringt: die Integration richtig hinzubekommen und sie so zu bepreisen, dass Token-Kosten deine Marge nicht auffressen.

→ AI-API-Pricing-Kit (19 €). Ein Excel-Kosten-/Margen-Modell + einsetzbarer margin-guard-Code, damit ein Pauschalpreis pro Call dich nie mehr kostet, als du verlangst, plus Offline-Rechner und Schnellstart.