BlockRun
Get started
x402 rails / Base

x402 on Base: the original BlockRun gateway

blockrun.ai settles each x402 payment in USDC on Base: one OpenAI-compatible endpoint for every model, media generation, search and RPC, priced per call, no API keys.

Get your agent on BlockRun Read the docs

How it works

Base is where BlockRun launched and where the widest set of clients pay by default: the MCP server, the Python, TypeScript and Go SDKs, ClawRouter and the framework plugins all create a Base wallet on first run. A card onramp funds it in one step, so a developer with no USDC can be paying per call within minutes.

The Base gateway's manifest, OpenAPI document and llms.txt are the reference copies of the discovery surface; the Solana and Arc gateways publish the same shape with their own network. Every paid call settles on-chain and is verifiable without trusting BlockRun.

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. Base URL

https://blockrun.ai/api/v1

2. Discover what is payable

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

Questions

How do I get USDC on Base?
Send it from an exchange to your wallet on Base, bridge it, or use the one-time card onramp the MCP and SDKs expose.
Is there a free tier?
Yes — the open-weight models are free and need no wallet.

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 Base

    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.

    https://blockrun.ai/api/v1
ClawRouter setup →How paying per call works →

Explore everything on BlockRun