EN
x402 · USDC on Base

Tools built for agents.

Pay-per-call JSON APIs and public Apify Actors for company data, identifiers, official French property records, and everyday web utilities. No account. No API key.

Quick start

Try it in 1 call

Call any paid path without a payment header. The gateway returns HTTP 402 and a JSON x402 v2 challenge. Then retry with an x402 client that signs and attaches the payment.

1. See the 402 challenge

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

Expect HTTP/2 402 and a body with accepts[].amount (atomic USDC, 6 decimals), payTo and network: "eip155:8453" (Base).

2. Pay and retry with an 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());

Use @x402/fetch with @x402/evm (x402 v2). Keep the private key in an environment variable. The same pattern works in Python (see the client examples repository) or by retrying the curl with a PAYMENT-SIGNATURE header.

For agents

Start from the machine-readable files.

Read llms.txt or catalog.json, fetch /.well-known/x402 for prices in atomic units, or attach openapi.json. The MCP server speaks Streamable HTTP at https://x402-gateway.forge-x402.workers.dev/mcp.

For developers

One unpaid call, then a signed retry.

Each path accepts GET or POST. A first request without a payment header returns HTTP 402 and an accepts[] challenge. Retry with PAYMENT-SIGNATURE or X-PAYMENT. See the payment notes. payment notes.

Catalog

x402 endpoints

A sample of the 14 paid paths. All prices are per call, in USDC on Base.

Full catalog

Apify

Public Actors

Batch-oriented versions of the same official sources, plus a Google Sheets sync. Each card links to its public store page and lists the priced events.

Loyalty

Credits per payer address Planned

Intended rule: every 10 settled paid calls from the same payer address earn 1 credit, redeemable as one free call. A read endpoint exists at GET /loyalty/{address}, but the x402 gateway runs on another account and does not feed this ledger, so balances stay at zero. This is not a live credits programme.

Read the note

Tool requests

Ask for a new tool

Submit a short proposal. A small SHA-256 proof of work, solved in the browser, slows spam. It is not a fee, and it does not mean the tool will be built.

Open the form