Verkaufen Sie Ihre API an AI-Agenten.
AI-Agenten können kein Kreditkartenformular ausfüllen. Sie können Ihnen in USDC bezahlen. Blockchain0x macht diesen einen API-Aufruf.
Ihre API wurde für Menschen entwickelt. Ihre Aufrufer sind jetzt Agenten.
Das nächste Jahrzehnt der API-Einnahmen wird nicht von menschlichen Anmeldungen kommen. Es wird von KI-Agenten kommen, die APIs im Namen ihrer Benutzer aufrufen, oft programmatisch und ohne menschliche Beteiligung. Diese Agenten können Ihren bestehenden Checkout nicht verwenden. Sie können kein Kreditkartenformular ausfüllen, kein Konto erstellen, keine Bestätigungs-E-Mail anklicken, sich kein Passwort merken.
Was sie tun können, ist, eine 402 Payment Required-Antwort zu lesen, den USDC-Betrag und den Empfänger aus dem JSON-Körper zu extrahieren, auf Base zu bezahlen und den Anruf mit einem Zahlungsnachweis erneut auszugeben. Das ist die gesamte Form des agentengesteuerten API-Handels. Das Kostenmodell (Abrechnung pro Anruf in Stablecoin) passt auch viel besser zur Nutzung durch Agenten als kartenbasierte Abonnements: Karten scheitern bei Transaktionen unter 1 Dollar; USDC auf Base kostet Cent für Gas; Rückbuchungen treten zwischen Maschinen nicht auf.
Blockchain0x ist die Brücke. Listen Sie die Routen auf, für die Sie in einer Preistabelle Gebühren erheben möchten, und montieren Sie den x402-Adapter. Wenn ein unbezahlter Anruf eine preislich festgelegte Route erreicht, gibt der Adapter eine 402 zurück, die genau beschreibt, was zu zahlen ist. Der Agent bezahlt auf Base und versucht es erneut mit einem X-Payment-Header; der Adapter überprüft dies und Ihr Handler wird ausgeführt. Sie sammeln USDC und betreiben Ihre API wie zuvor. Nichts an Ihrer Geschäftslogik ändert sich; die Abrechnungsschicht läuft parallel.
Der HTTP-Statuscode hat endlich einen Zweck.
HTTP 402 was reserved in the original spec for "future use" and never standardized. For thirty years it sat unused while the internet built per-account subscription billing on top of 200/401/403. With Coinbase's x402 protocol, 402 finally has a standard implementation: any API that needs payment-before-it-runs can return a structured 402, and any client that understands the spec can pay and retry.
HTTP/1.1 402 Payment Required
Content-Type: application/json
{
"resource": "POST /api/expensive-operation",
"accepts": [
{
"scheme": "exact-usdc",
"network": "mainnet",
"chainId": "eip155:8453",
"payToAddress": "0xYourAgentWalletAddress",
"amountWeiUsdc": "500000",
"paymentRequestId": "pr_demo",
"maxAgeSeconds": 60
}
]
}Was die Anforderung accepts[] bedeutet
- schema - das Zahlungsschema. exact-usdc bedeutet einen genauen USDC-Betrag auf einer EVM-Kette. Der Kunde stimmt dem vor der Zahlung zu.
- netzwerk / chainId - die Kette, auf der abgerechnet werden soll (Mainnet ist Base, CAIP-2 eip155:8453). Eine Migration kann beide Netzwerke angeben, indem sie zwei Anforderungen in accepts auflistet.
- payToAddress / amountWeiUsdc - die Empfänger-Wallet und der genaue Betrag in USDC-Basiseinheiten (500000 = 0.50 USDC, 6 Dezimalstellen). Der Kunde überprüft beides, bevor er bezahlt.
- paymentRequestId - verknüpft die Zahlung mit diesem Angebot. Der Adapter lehnt eine X-Zahlung ab, die auf eine andere paymentRequestId verweist als die angegebene Route.
- maxAgeSeconds - wie frisch die Zahlung sein muss. Eine Zahlung, die älter als dieses Fenster ist, wird abgelehnt und der Anrufer muss erneut zahlen.
x402 ist maschine-zu-maschine: ein x402-bewusster Client liest accepts, bezahlt die gewählte Anforderung on-chain und gibt die Anfrage mit einem X-Payment-Header zurück, den der Adapter überprüft. Ein Client, der x402 nicht spricht, erhält einfach die 402 und erhält kein Ergebnis, was das korrekte Ergebnis ist (der Aufruf wurde nicht bezahlt). Es gibt in diesem Ablauf keine gehostete Checkout-Seite; die Zahlung wird programmatisch von der Wallet des Anrufers beglichen.
Eine Preistabelle. Drei Sprachen. Gleiche Form.
Sie montieren einen Adapter und geben ihm eine Preistabelle, die nach METHOD plus Pfad indiziert ist. Es sichert nur die Routen, die Sie auflisten; Ihr Handler sieht niemals einen unbezahlten Aufruf, da der X-Payment-Header bereits verifiziert wurde, wenn er ausgeführt wird. Die Form ist identisch in Python, TypeScript und Go - das X-Payment-Drahtformat ist dasselbe, sodass ein Go-Server Header akzeptiert, die von einem Python-Client erstellt wurden.
from flask import Flask
from blockchain0x import Client
from blockchain0x_x402.server import x402_before_request_factory, PricingEntry
sdk = Client() # reads BLOCKCHAIN0X_API_KEY
app = Flask(__name__)
# Only routes named in the pricing table are gated.
app.before_request(x402_before_request_factory(
sdk=sdk,
pricing={
"POST /api/expensive-operation": PricingEntry(
amount_usdc="0.50",
pay_to_address="0xYourAgentWalletAddress",
payment_request_id="pr_demo",
),
},
))
@app.route("/api/expensive-operation", methods=["POST"])
def expensive_operation():
return run_the_work() # only runs after X-Payment verifiesimport express from "express";
import { createClient } from "@blockchain0x/node";
import { createX402Middleware } from "@blockchain0x/x402/server/express";
const sdk = createClient({ apiKey: process.env.BLOCKCHAIN0X_API_KEY! });
const app = express();
// Only routes named in the pricing table are gated.
app.use(createX402Middleware({
sdk,
pricing: {
"POST /api/expensive-operation": {
amountUsdc: "0.50",
payToAddress: "0xYourAgentWalletAddress",
paymentRequestId: "pr_demo",
},
},
}));
app.post("/api/expensive-operation", async (req, res) => {
res.json(await runTheWork()); // req.x402Payment holds the verified payment
});import (
"net/http"
x402 "tosh-labs/blockchain0x-x402-go"
)
func main() {
pricing := map[string]x402.PricingEntry{
"POST /api/expensive-operation": {
AmountUSDC: "0.50",
PayToAddress: "0xYourAgentWalletAddress",
PaymentRequestID: "pr_demo",
},
}
// serverSdk is your Blockchain0x Go SDK client.
h := x402.Middleware(x402.ServerOptions{Sdk: serverSdk, Pricing: pricing})(
http.HandlerFunc(expensiveOperation))
http.Handle("/api/expensive-operation", h)
http.ListenAndServe(":8080", nil)
}Wir liefern Serveradapter für Express und Fastify (Node), ASGI (Starlette und FastAPI) und Flask (Python) sowie Go's net/http. Für andere Frameworks sind der 402-Body und der X-Payment-Header einfaches HTTP, das die Drahthelfer in @blockchain0x/x402 erstellen und analysieren - schreiben Sie die Überprüfung in der Idiom Ihres Stacks von Hand. Ruby- und JVM-x402-Pakete werden für die Client-Seite veröffentlicht.
Wann man jedes Tool erreichen sollte.
Stripe ist das richtige Werkzeug für den menschlichen Checkout. Blockchain0x ist das richtige Werkzeug für den Agenten-Checkout. Sie lösen unterschiedliche Probleme und sitzen häufig nebeneinander in derselben API.
| Dimension | Blockchain0x | Stripe Checkout |
|---|---|---|
| Käufer | Jeder HTTP-Client (menschlich oder AI-Agent) | Mensch am Browser |
| Auth erforderlich vor der Zahlung | Nein - der erste Aufruf gibt 402 mit den Zahlungsanforderungen zurück. | Ja - E-Mail + Kartenformular |
| Abwicklungszeit | 5 Sekunden (USDC auf Base) | 2-7 Tage (Kartennetzwerke) |
| Rückbuchungsrisiko | Keine (USDC ist endgültig) | Bis zu 120 Tage Rückbuchungsfenster |
| Kostenökonomie pro Transaktion | Funktioniert bei $0,01-$0,10 pro Anruf (Base-Gas + unsere Gebühr) | Karten Gebühren machen Transaktionen unter $1 unwirtschaftlich |
| Rückerstattungen | Manuell - Ihr Code sendet USDC zurück an die Zahleradresse | Automatisiert über das Stripe-Dashboard |
| Internationale Unterstützung | Gleiche Wallet, jedes Land, keine zusätzliche Konfiguration | Länderspezifische Lizenzierung, Währungsumrechnung, regionale Regeln |
| Am besten für | Programmgesteuerte agentengetriebene API-Nutzung | Menschlich gesteuertes Checkout (SaaS-Anmeldung, E-Commerce) |
Das Muster, auf das die meisten API-Anbieter hinauslaufen: Behalten Sie Stripe für den menschlichen Anmeldefluss (Ihr Dashboard, Ihre Abonnementproduktseite); fügen Sie Blockchain0x an der API-Grenze für programmgesteuerten Agentenzugriff hinzu. Der x402-Adapter schützt nur die Routen, die Sie in seiner Preistabelle angegeben haben, sodass Ihre menschlichen, Stripe-authentifizierten Routen unberührt bleiben. Richten Sie Agenten auf die preislich festgelegten Routen und Menschen auf den Rest aus, und beide Zielgruppen werden vom gleichen API-Code bedient.
Pro für frühen Traffic. Business, wenn Audit-Logs erforderlich werden.
API-Anbieter beginnen fast immer ab dem ersten Tag mit Pro: Kostenlos ist nur lesbar, und der x402-Adapter benötigt den API-Zugang, um Zahlungen zu überprüfen und abzuwickeln sowie Webhooks zu verfolgen. Hochfrequentierte APIs überschreiten das Business-Gebiet, wenn das monatliche Volumen steigt. Siehe die Preisseite für die genauen Kosten pro Agent und wo die Stufen liegen.
- Free: nur für das Dashboard und die Metadaten-Erkundung nützlich. Nur lesend, daher kann der Adapter keine Zahlungen abwickeln.
- Pro: Standard für Live-API-Monetarisierung. Voller API-Zugriff, Webhooks, Exporte.
- Business: wenn Sie Audit-Logs für Compliance benötigen oder höhere API-Rate-Limits.