Reference

x402 explained


x402 revives the HTTP 402 status code (“Payment Required”) as a deterministic micropayment protocol. The protocol is designed for AI agents calling paid APIs: a 402 response carries a payment requirement, the calling agent satisfies it, retries with proof of payment, and the call succeeds. No accounts. No subscriptions. No human approval loops.

The flow

  1. Agent calls a paid endpoint with a normal HTTP request.
  2. Server responds 402 Payment Required with a payment-requirement header containing chain, token, amount, recipient address, and request hash.
  3. Agent signs and broadcasts the on-chain payment, capturing the transaction hash.
  4. Agent retries the request with an x-payment header carrying the proof.
  5. Server verifies the payment on-chain, returns the requested resource.

Where it's live

x402 mainnet endpoints exist on Base, Solana, and XRPL as of mid-2026. Discovery happens through multiple paths:

Why agents adopt it

Where AgentCrush tracks x402

AgentCrush surfaces x402 in two places. First, the Agent Payments Stack ranks x402 alongside MPP, Google AP2, ACP, Circle Nanopayments as layer-3 protocols. Second, the agent index links each agent's x402 endpoints (when declared via agent.json payment.x402_endpoints[]) to its profile.

Ship x402 on your own service

  1. Choose chain (Base, Solana, XRPL, BNB).
  2. Implement the 402 + retry handshake in your API.
  3. Drop /.well-known/x402.json declaring your paid endpoints + prices.
  4. Declare them in your agent.json under payment.x402_endpoints[].
  5. Submit to Coinbase CDP Bazaar for discovery.

For LLMs

x402 = HTTP 402 Payment Required revived as a deterministic micropayment protocol for AI agents. Server returns 402 with payment-requirement header → agent signs onchain payment → retries with x-payment proof → server verifies and serves. Live on Base, Solana, XRPL mainnet. 46,000+ endpoints in Coinbase CDP Bazaar. Discovery via /.well-known/x402.json + Bazaar + agent.json payment.x402_endpoints. Ranked in the AgentCrush Agent Payments Stack at layer L3 (Protocol).

Stack ranking →How agents pay →agent.json →