BlockRun
Get started
x402 rails / Coinbase x402 Bazaar

Discovering BlockRun through x402scan and the Bazaar

BlockRun's endpoints are registered on x402scan and discoverable via the x402 Bazaar conventions: an OpenAPI document with x402 extensions plus a /.well-known/x402 manifest.

Get your agent on BlockRun Read the docs

How it works

x402scan indexes sellers by reading their OpenAPI document first and the /.well-known/x402 manifest as a fallback; the Bazaar conventions add input schemas on paid POST operations so an agent can construct a valid request from the listing alone. BlockRun publishes both, derived from the same route table, with free operations marked so a strict-mode probe does not mistake them for paid.

Every paid BlockRun endpoint that a listing can cleanly probe is registered; the few templated poll routes are served but excluded from registration because a literal probe of a placeholder id has no real job behind it.

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. What an indexer reads

curl https://blockrun.ai/openapi.json
curl https://blockrun.ai/.well-known/x402

Questions

Can an agent construct a request from the listing?
Yes for the paid POST routes: the OpenAPI document carries request schemas and examples for them.
Why are some routes missing from the listing?
Templated poll routes are excluded from registration because a literal probe has no job to poll; they still work at runtime.

Related

Two ways to run this

Get an API key

Sign in, get a key, and call the same endpoints with usage billed to your account. For teams that want one invoice instead of one wallet.

Get an API key 

Or let your agent pay per call, in USDC

No account, no API key. Three steps, and the last one is the request this page is about.

  1. 01
    Point your agent at BlockRun

    Install ClawRouter, or add the BlockRun MCP server to Claude Code, Cursor, Codex or OpenClaw. Any OpenAI-compatible client works too — change the base URL, nothing else.

    curl -fsSL https://blockrun.ai/ClawRouter-update | bash
  2. 02
    Fund a wallet with USDC

    Send USDC to a wallet on Base or Solana. There is no account to create and no API key to issue: the wallet is the account, and it pays per call.

  3. 03
    Use BlockRun from Coinbase x402 Bazaar

    The first call returns HTTP 402 with the exact price, your agent signs it, and the answer comes back. Payment settles on-chain; nothing is charged if the call fails.

    curl https://blockrun.ai/openapi.json
curl https://blockrun.ai/.well-known/x402
ClawRouter setup →How paying per call works →

Explore everything on BlockRun