x402 service discovery
x402 Endpoints (USDC pay-per-call)
GET /.well-known/x402.json
Service discovery — list of paid tiers, their prices, and the settlement chain.
GET
x402 service discovery
Free, no payment required. Returns the live price list — kept in
sync with the actual middleware config so an out-of-band dashboard
can’t drift from what the API enforces.
Request
Response
Schema
Tier history
- 2026-05-05 —
/label($0.10) and/screen/light($0.20) removed. Their data was merged into the new/screen/{chain}/{address}tier above for$0.10. Old paths now return 404. - 2026-04-30 — initial 4-tier launch.
Conventions
- The
endpointstrings are templates, not regex patterns. Use{chain}and{address}as placeholders matching the values from networks. - The price-list is the SINGLE SOURCE OF TRUTH at runtime — the
middleware uses the same data to build
payment-requiredquotes, so what’s listed is what you’ll be charged.
Response
200 - application/json
Successful Response
The response is of type Response Discovery Well Known X402 Json Get · object.

