What x402 is and how an agent pays for an API call
x402 turns the old HTTP status code 402 Payment Required into a real payment step. An agent can buy one API call for a fraction of a cent, with no signup, no API key and no card.
The flow in four steps
- The agent calls the API like any other URL.
- The server answers
402with a price quote: amount, token (USDC), network (Base iseip155:8453) and the address to pay. In version 2 the quote is in thePAYMENT-REQUIREDheader. - The agent's wallet signs a USDC transfer authorization for that exact amount and sends the same request again with an
X-PAYMENTheader. - The server checks the signature with a facilitator, returns the answer, and the facilitator settles the transfer on chain. The receipt comes back in
PAYMENT-RESPONSE.
The payer needs USDC only, not ETH: in the exact scheme the facilitator pays the gas. Amounts are in USDC's 6 decimal units, so "1000" means $0.001.
See a real price quote first (free)
This call costs nothing. It shows you the 402 answer an agent would receive:
curl -i 'https://search.cyberwarex.com/search?q=x402'
Look for HTTP/2 402, the payment-required header and the accepts list in the body.
Pay from Python
pip install "x402[evm,requests]"
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact import ExactEvmScheme
# A wallet that holds a little USDC on Base. It needs no ETH: the facilitator pays the gas.
account = Account.from_key(PRIVATE_KEY)
client = x402ClientSync()
client.register("eip155:8453", ExactEvmScheme(EthAccountSigner(account)))
session = x402_requests(client)
r = session.get("https://web.cyberwarex.com/fetch?url=https://example.com&format=markdown")
print(r.status_code) # 200 after payment
print(r.headers.get("PAYMENT-RESPONSE")) # settlement receipt (base64 JSON with the tx hash)
print(r.json()["content"][:200])
The example pays $0.001 to our page reader ours. Any x402 API works the same way: change the URL.
Old samples that import x402.clients are version 1 and fail on current installs.
Pay from TypeScript
npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPaymentFromConfig } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm";
import { privateKeyToAccount } from "viem/accounts";
const pay = wrapFetchWithPaymentFromConfig(fetch, {
schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(privateKeyToAccount(PRIVATE_KEY)) }],
});
const r = await pay("https://web.cyberwarex.com/fetch?url=https://example.com&format=markdown");
console.log(r.status, await r.json());
The older x402-fetch package (1.x) rejects the version 2 network id; use @x402/fetch.
Keep a budget
- Use a separate wallet for the agent and put only what it may spend in it. That is the hard limit.
- Check
accepts[0].amountbefore signing and refuse anything above your own per-call cap. - If the agent calls one provider a lot, a prepaid key can save the signing step on every call. Ours: safe.cyberwarex.com/subscribe?usd=5 (pay once with x402, any top-up from $0.50 to $50).
Read more
- Specification and SDKs: x402.org and github.com/coinbase/x402
- All our x402 services in one list: our service list
Checked 2026-11-04: the Python code above was run against the live service and settled a real $0.001 payment on Base. The TypeScript code was last run with a real payment on 2026-10-19.