NL
x402 · USDC op Base

Tools gebouwd voor agents.

Pay-per-call JSON-API’s en openbare Apify Actors voor bedrijfsdata, identificatoren, officiële Franse vastgoedgegevens en alledaagse webhulpprogramma’s. Geen account. Geen API-sleutel.

Snelstart

Probeer het in 1 aanroep

Roep een betaald pad aan zonder betalingsheader. De gateway geeft HTTP 402 en een JSON x402 v2-challenge terug. Probeer opnieuw met een x402-client die de betaling ondertekent en toevoegt.

1. Bekijk de 402-challenge

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

Verwacht HTTP/2 402 en een body met accepts[].amount (atomaire USDC, 6 decimalen), payTo en network: "eip155:8453" (Base).

2. Betaal en probeer opnieuw met een x402-client

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());

Gebruik @x402/fetch met @x402/evm (x402 v2). Bewaar de privésleutel in een omgevingsvariabele. Hetzelfde patroon werkt in Python (zie de voorbeelden-repo) of door de curl te herhalen met een PAYMENT-SIGNATURE-header.

Voor agents

Begin bij de machineleesbare bestanden.

Lees llms.txt of catalog.json, haal /.well-known/x402 op voor prijzen in atomaire eenheden, of voeg openapi.json toe. De MCP-server spreekt Streamable HTTP op https://x402-gateway.forge-x402.workers.dev/mcp.

Voor ontwikkelaars

Eén onbetaalde aanroep, daarna een ondertekende retry.

Elk pad accepteert GET of POST. Een eerste verzoek zonder betalingsheader geeft HTTP 402 en een accepts[]-challenge terug. Probeer opnieuw met PAYMENT-SIGNATURE of X-PAYMENT. Zie de betalingsnotities. betalingsnotities.

Catalogus

x402-eindpunten

Een steekproef van de 14 betaalde paden. Alle prijzen zijn per aanroep, in USDC op Base.

Volledige catalogus

Apify

Openbare Actors

Batchgerichte versies van dezelfde officiële bronnen, plus een Google Sheets-synchronisatie. Elke kaart linkt naar de openbare storepagina en somt de beprijsde gebeurtenissen op.

Loyaliteit

Tegoed per betaleradres Gepland

Beoogde regel: elke 10 vereffende betaalde aanroepen vanaf hetzelfde betaleradres leveren 1 tegoed op, inwisselbaar voor één gratis aanroep. Er is een lees-eindpunt op GET /loyalty/{address}, maar de x402-gateway draait op een ander account en voedt dit grootboek niet, dus saldo’s blijven nul. Dit is geen live tegoedprogramma.

Lees de toelichting

Toolverzoeken

Vraag een nieuwe tool aan

Dien een kort voorstel in. Een kleine SHA-256-proof-of-work, in de browser opgelost, vertraagt spam. Het is geen vergoeding en geen garantie dat de tool wordt gebouwd.

Open het formulier