BlockRun
x402 rails / x402 v2

x402 v2 on BlockRun: the manifest, the networks, the headers

BlockRun publishes an x402 v2 manifest listing every payable endpoint with its price and CAIP-2 network, next to the v1 list and an OpenAPI document with an x402 scheme.

How it works

x402 is the HTTP payment protocol: a paid endpoint answers a request without payment with a 402 and the requirements, the client signs a USDC authorization and retries. The v2 conventions add a machine-readable manifest of endpoints with prices and CAIP-2 network ids, so an agent can decide what it can afford before it calls.

BlockRun's manifest at /.well-known/x402 carries both the v1 resource list and the v2 endpoints array, derived from the same OpenAPI document the API is described by, so the three cannot disagree on a price. The OpenAPI document declares the x402 security scheme on every paid operation and marks free ones explicitly.

Behind it is the BlockRun catalog: 78 chat models plus image, video, music and speech generation, search, market data and multi-chain RPC, priced per call. 6 open-weight models are free and need no wallet.

Setup

1. Read the manifest

curl https://blockrun.ai/.well-known/x402 | jq '.endpoints[:3]'

2. Read the OpenAPI security scheme

curl https://blockrun.ai/openapi.json | jq '.components.securitySchemes'

Questions

Do v1 clients still work?
Yes. The manifest keeps the v1 resource list and the 402 flow is unchanged.
Where do the prices in the manifest come from?
From the OpenAPI document, at render. The 402 is always the authoritative quote for a specific call.