Zum Hauptinhalt springen
PERSONA 2 VARIANTE - API-ANBIETER

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.

DER SCHMERZ

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.

402 ZAHLUNG ERFORDERLICH

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.

IHRE API GIBT DIESEN 402 BODY ZURÜCK, WENN EIN ANRUF NICHT BEZAHLT WURDE
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.

ADAPTER-MUSTER

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.

PYTHON (FLASK)
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 verifies
TYPESCRIPT (EXPRESS)
import 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
});
GO (NET/HTTP)
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.

VS STRIPE CHECKOUT

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.

DimensionBlockchain0xStripe Checkout
KäuferJeder HTTP-Client (menschlich oder AI-Agent)Mensch am Browser
Auth erforderlich vor der ZahlungNein - der erste Aufruf gibt 402 mit den Zahlungsanforderungen zurück.Ja - E-Mail + Kartenformular
Abwicklungszeit5 Sekunden (USDC auf Base)2-7 Tage (Kartennetzwerke)
RückbuchungsrisikoKeine (USDC ist endgültig)Bis zu 120 Tage Rückbuchungsfenster
Kostenökonomie pro TransaktionFunktioniert bei $0,01-$0,10 pro Anruf (Base-Gas + unsere Gebühr)Karten Gebühren machen Transaktionen unter $1 unwirtschaftlich
RückerstattungenManuell - Ihr Code sendet USDC zurück an die ZahleradresseAutomatisiert über das Stripe-Dashboard
Internationale UnterstützungGleiche Wallet, jedes Land, keine zusätzliche KonfigurationLänderspezifische Lizenzierung, Währungsumrechnung, regionale Regeln
Am besten fürProgrammgesteuerte agentengetriebene API-NutzungMenschlich 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.

WELCHER PLAN PASST

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.
Vollständige Preisübersicht anzeigen
HÄUFIG GESTELLTE FRAGEN

Fünf Fragen an API-Anbieter.

Kann ich Stripe zusammen mit Blockchain0x für dieselbe API verwenden?

Ja, und viele API-Anbieter tun dies. Das Muster: Behalten Sie Ihren bestehenden Stripe-basierten menschlichen Anmeldefluss bei und listen Sie nur die agentenorientierten Routen in der x402-Preistabelle auf. Der Adapter sperrt genau diese Routen; alles, was nicht in der Tabelle steht (einschließlich der Routen, die Ihre Stripe-authentifizierten Kunden aufrufen), geht direkt durch, unbeeinflusst. Wenn Sie eine einzelne Route haben möchten, die beide bedient, überprüfen Sie Ihren eigenen API-Schlüssel im Handler und überspringen Sie den kostenpflichtigen Pfad für authentifizierte Anrufer. Beide Zielgruppen erhalten, was sie wollen, ohne dass ein Pfad den anderen blockiert.

Was ist, wenn ein KI-Agent bezahlt und dann aussteigt, bevor er den Anruf erneut versucht?

Die Zahlung ist weiterhin on-chain gültig; sie wird nur nicht verwendet. Die Wallet des Agenten zeigt eine erfolgreiche USDC-Überweisung an Ihre Adresse an. Aus der Perspektive des Agenten hat er die USDC verloren; aus Ihrer Sicht wurden Sie für einen Anruf bezahlt, der nie ausgeführt wurde. Dies ist in der Praxis selten (der x402-Client versucht es sofort nach der Zahlung erneut), aber wenn Sie defensiv sein möchten, können Sie verifizierte Zahlungen verfolgen, die nie einen abgeschlossenen Anruf erzeugt haben, und die USDC selbst mit payments.create zurücksenden, wobei Sie die ursprüngliche Zahleradresse bezahlen. Es gibt keinen separaten Rückerstattungsendpunkt - eine Rückerstattung ist einfach eine Zahlung in die andere Richtung.

Wie versioniere ich meine API und Preisänderungen?

Jeder Eintrag in der Preistabelle ist pro Route, sodass unterschiedliche Routen unterschiedliche Preise verlangen können. Für die Versionierung ist das empfohlene Muster, v2-Endpunkte neben v1 mit den neuen Preisen als neue Einträge in der Preistabelle bereitzustellen; die Kunden sehen den neuen Betrag in ihrer ersten 402-Antwort auf der v2-Route und zahlen entsprechend. Plötzliche Preiserhöhungen auf stabilen Routen sind schlechtes Protokollverhalten; wir empfehlen, die alte Route abzulehnen und einen 410 Gone bereitzustellen, der auf die neue Route zum neuen Preis verweist.

Wie sieht Beobachtbarkeit aus - Protokolle, Metriken, Warnungen?

Jede Zahlung wird im Blockchain0x-Dashboard mit der Wallet des Zahlers, dem Betrag und dem Zeitstempel angezeigt, und dieselben Daten kommen an Ihrem payment.received Webhook an, sodass Sie sie in Datadog, Splunk oder Ihren eigenen Protokollstapel streamen können. Der Adapter läuft auf Ihrem Server, sodass die Anforderungslevel-Signale (welche Route zitiert wurde, jede 402, die Sie zurückgegeben haben, jede X-Zahlung, die Sie verifiziert haben) Ihnen gehören, um sie zu protokollieren und als Metriken in dem Format auszugeben, das Ihr Stapel verwendet. Richten Sie Warnungen für die offensichtlichen Fälle ein: ein plötzlicher Anstieg der 402-Antworten oder ein Rückgang der verifiziert-zahlungsrate.

Was ist mit regulatorischen Fragen - bin ich ein Gelddienstleistungsunternehmen, wenn ich dies tue?

Wahrscheinlich nicht, aber das ist von der Gerichtsbarkeit abhängig und wir sind nicht Ihre Anwälte. Der Grund: Sie erhalten Zahlungen für die von Ihnen erbrachten Dienstleistungen, nicht für die Übertragung von Geld zwischen Dritten (was der Auslöser für den MSB-Status in den USA ist). USDC wird in den meisten Gerichtsbarkeiten als Zahlungs-Stablecoin anerkannt. Sie schulden Steuern auf die USD-äquivalenten Einnahmen; wir erstellen die Aufzeichnungen, die Sie dafür benötigen. Wenn Sie in einem B2B-Kontext mit hohem Volumen oder in einer Gerichtsbarkeit mit strengen Krypto-Regeln (Deutschland, Singapur für bestimmte Formen) tätig sind, holen Sie sich spezifische rechtliche Beratung, bevor Sie den Produktionsverkehr umschalten. Wir können Sie an Firmen verweisen, die diese Arbeit für frühere Kunden erledigt haben.

Lassen Sie Agenten für Ihre API bezahlen.

Fügen Sie eine Route zur Preistabelle hinzu und montieren Sie den Adapter. Stripe bleibt für Menschen. Beide Zielgruppen werden bedient.