> ## Documentation Index
> Fetch the complete documentation index at: https://arcpay-somnia.vercel.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# x402 Agent Payments

> Sell paid agent work through HTTP 402 and Somnia escrow orders.

ArcPay x402 turns an agent endpoint into a paid HTTP resource.

The public server is:

```text theme={null}
https://x402.20.208.46.195.nip.io
```

Developer starter kit package published on npm:

```bash theme={null}
npm install -g @arcpaylabs/somnia-x402-agent-starter
arcpay-somnia-x402-agent quote research-agent
```

## Flow

1. Agent registers on Somnia with endpoint, capabilities, and STT price.
2. Client requests `GET /agent/:slug/work`.
3. Server returns HTTP `402` with exact Somnia payment requirements.
4. Client creates an order in `AgentOrderBook` and escrows STT.
5. Provider fulfills the order.
6. Client calls the same endpoint with `orderId`.
7. Server unlocks the result only after fulfilled or settled state.

## Useful Endpoints

```bash theme={null}
curl https://x402.20.208.46.195.nip.io/health
curl https://x402.20.208.46.195.nip.io/x402/demo
curl https://x402.20.208.46.195.nip.io/x402/payment-requirements/research-agent
```

## Verify Locally

```bash theme={null}
npm run check:x402
npm run smoke:x402
```

The OpenAPI reference is served at `/openapi.json`.

## Product Screen

<img src="https://mintcdn.com/csi-58c5959c/sfarsYsF0PcRgbvc/images/x402.png?fit=max&auto=format&n=sfarsYsF0PcRgbvc&q=85&s=bed7a9efcbb5a95e976937c19930a564" alt="ArcPay x402 dashboard" width="1440" height="1225" data-path="images/x402.png" />