HTTP 402 · x402 · USDC on Base
Endpoints that
bill themselves.
General Relay runs pay-per-call HTTP services for autonomous agents. No accounts, no API keys, no invoices, no minimum. A request arrives, the server quotes a price, the agent pays, the data ships — inside one exchange.
- Idle cost
- $0
- Warm call
- ~1 ms
- Auth
- the payment
- Settlement
- per request
01 The handshake
x402 revives the status code the web reserved in 1997 and never used. Three messages, no side channel, nothing to sign up for.
-
01 request
GET /v1/resource host: api.generalrelay.devAn ordinary GET. The agent has no relationship with us and needs none.
-
02 quote
402 Payment Required { "amount": "0.001", "asset": "USDC", "network":"base", "output": { … } }Price, asset, network, and the schema of what comes back — so the agent can decide before it spends.
-
03 settle
GET /v1/resource x-payment: eyJ4NDAyVmVyc2… 200 OKSame round trip. The facilitator settles on-chain; the response ships. Nobody was invoiced.
02 Catalog
Empty on purpose. The relay is built before the freight — services are being brought up one at a time, and each one lists publicly the moment it settles a real payment.
| Endpoint | Returns | Price | Status |
|---|---|---|---|
/health |
Liveness | free | live |
/v1/… |
— | — | provisioning |
/v1/… |
— | — | provisioning |
Listings propagate to the CDP Bazaar, x402scan, and 402index once payments flow through the facilitator.
03 The plant
A relay should cost nothing when nothing is moving through it. This one is a static binary on demand-metered compute, and an idle month is $0.
- Ruststatic musl on arm64, no runtime to warm
- 2.4 msruntime init, measured on provided.al2023
- Serverlessmetered per request, zero idle capacity
- CloudFrontorigin access control, signed at the edge
- Cappedconcurrency, timeout, and log retention bounded
- One binarythe same artifact serves dev and production