DE
x402 · USDC auf Base

Tools, die für Agents gebaut sind.

Pay-per-Call-JSON-APIs und öffentliche Apify-Actors für Unternehmensdaten, Identifikatoren, offizielle französische Immobiliendaten und alltägliche Web-Utilities. Kein Konto. Kein API-Schlüssel.

Schnellstart

In einem Aufruf testen

Rufen Sie einen bezahlten Pfad ohne Zahlungs-Header auf. Das Gateway antwortet mit HTTP 402 und einer JSON-x402-v2-Challenge. Wiederholen Sie den Aufruf mit einem x402-Client, der die Zahlung signiert und anhängt.

1. Die 402-Challenge ansehen

curl -sS -D - "https://x402-gateway.forge-x402.workers.dev/api/iban?iban=FR7630006000011234567890189"

Erwartet wird HTTP/2 402 und ein Body mit accepts[].amount (atomare USDC, 6 Dezimalstellen), payTo und network: "eip155:8453" (Base).

2. Zahlen und mit einem x402-Client wiederholen

import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.EVM_PRIVATE_KEY);
const fetchWithPayment = wrapFetchWithPaymentFromConfig(fetch, {
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(account) }],
});

const res = await fetchWithPayment(
  "https://x402-gateway.forge-x402.workers.dev/api/iban?iban=FR7630006000011234567890189"
);
console.log(await res.json());

Verwenden Sie @x402/fetch mit @x402/evm (x402 v2). Bewahren Sie den privaten Schlüssel in einer Umgebungsvariable auf. Dasselbe Muster funktioniert in Python (siehe das Beispiel-Repository) oder durch erneutes curl mit einem PAYMENT-SIGNATURE-Header.

Für Agents

Beginnen Sie mit den maschinenlesbaren Dateien.

Lesen Sie llms.txt oder catalog.json, rufen Sie /.well-known/x402 für Preise in atomaren Einheiten ab, oder hängen Sie openapi.json an. Der MCP-Server spricht Streamable HTTP unter https://x402-gateway.forge-x402.workers.dev/mcp.

Für Entwickler

Ein unbezahlter Aufruf, dann ein signierter Retry.

Jeder Pfad akzeptiert GET oder POST. Eine erste Anfrage ohne Zahlungs-Header liefert HTTP 402 und eine accepts[]-Challenge. Wiederholen Sie den Aufruf mit PAYMENT-SIGNATURE oder X-PAYMENT. Siehe die Zahlungshinweise. Zahlungshinweise.

Katalog

x402-Endpunkte

Eine Auswahl der 14 bezahlten Pfade. Alle Preise gelten pro Aufruf, in USDC auf Base.

Vollständiger Katalog

Apify

Öffentliche Actors

Stapelorientierte Versionen derselben offiziellen Quellen, plus eine Google-Sheets-Synchronisierung. Jede Karte verlinkt die öffentliche Store-Seite und listet die bepreisten Ereignisse.

Treueprogramm

Guthaben pro Zahleradresse Geplant

Vorgesehene Regel: Je 10 abgerechnete bezahlte Aufrufe derselben Zahleradresse ergeben 1 Guthaben, einlösbar als ein kostenloser Aufruf. Ein Lese-Endpunkt existiert unter GET /loyalty/{address}, aber das x402-Gateway läuft auf einem anderen Konto und speist dieses Ledger nicht, daher bleiben die Salden bei null. Dies ist kein laufendes Guthabenprogramm.

Hinweis lesen

Tool-Wünsche

Ein neues Tool vorschlagen

Reichen Sie einen kurzen Vorschlag ein. Ein kleines SHA-256-Proof-of-Work, im Browser gelöst, bremst Spam. Es ist keine Gebühr und keine Zusage, dass das Tool gebaut wird.

Formular öffnen