BlockRun
Get started

x402 Endpoints

Complete catalog of every x402-enabled endpoint BlockRun exposes, across all gateway domains. Intended for x402scan, the Circle x402 ecosystem, and protocol integrators.

For programmatic integration, prefer the discovery endpoints at the bottom of this page — they always reflect the live state.

Don't hard-code prices

Pricing is embedded in every 402 response and published live at /api/v1/models. Read amounts at request time rather than copying them from this page.

Gateways

The same paths are available on each gateway. The 402 response advertises which network and asset the gateway accepts.

DomainNetworkAssetSettlementNotes
blockrun.aiBase mainnet — eip155:8453USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913Per-call onchainDefault gateway. EIP-3009 / x402 v2.
sol.blockrun.aiSolana mainnet — solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdpUSDC SPL EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1vPer-call onchainSolana SPL transfers.
nano.blockrun.aiBase mainnet via Circle GatewayUSDCBatched (Nanopayments)Gas-free, sub-cent floor, batched onchain settlement. See the Nanopayments launch post.
xrpl.blockrun.aiXRP LedgerRLUSD (Ripple-issued USD)Per-call onchainDeprecated (being sunset) — use Base or Solana for new integrations. See the XRPL SDK notice.
testnet.blockrun.aiBase Sepolia — eip155:84532USDC 0x036CbD53842c5426634e7929541eC2318f3dCF7ePer-call onchainFree test USDC. Smaller model catalog.

All gateways implement x402 v2. Facilitators: Coinbase CDP for Base, native Solana verification, t54.ai for XRPL.

Discovery

GET https://blockrun.ai/.well-known/x402     # x402 v1 resource list + v2 metadata
GET https://blockrun.ai/openapi.json         # Full OpenAPI 3.1 spec (read by x402scan)
GET https://blockrun.ai/api/v1/models        # Live model catalog with pricing

Replace blockrun.ai with sol.blockrun.ai, nano.blockrun.ai, xrpl.blockrun.ai, or testnet.blockrun.ai to discover the same endpoints scoped to a different network.

AI Model Gateway

OpenAI-compatible. 60 models across chat, reasoning, coding, and vision — plus image, video, music, and speech generation. Per-model pricing is published live at /api/v1/models.

MethodPathPurposePricing
POST/api/v1/chat/completionsOpenAI-compatible chatToken-based, see /api/v1/models
POST/api/v1/chat/{model}Chat completions with the model in the pathToken-based
POST/api/v1/messagesAnthropic-compatible messagesToken-based
POST/api/v1/images/generationsImage generation (gpt-image-1/2, Nano Banana, CogView-4, Grok Imagine)Per image, per size
GET/api/v1/images/generations/{id}Async image poll for slow models (gpt-image-2, etc.)Free
POST/api/v1/images/image2imageImage edit / inpainting + multi-image fusion (gpt-image-1/2, Nano Banana, Nano Banana Pro)Per image
POST/api/v1/videos/generationsVideo generation (Seedance, Grok Imagine Video, Sora 2)Per second / token-metered, varies
GET/api/v1/videos/generations/{id}Async video poll (settlement happens here on completion)Free
POST/api/v1/videosStandard multimodal content[] body — delegates to /videos/generationsPer second / token-metered
POST/api/v1/audio/speechText-to-speech (ElevenLabs voices)$0.05–$0.10 / 1k chars
POST/api/v1/audio/generationsMusic generation (MiniMax Music)$0.15 / track
POST/api/v1/audio/sound-effectsSound-effect generation$0.052 / generation
GET/api/v1/audio/voicesList available TTS voicesFree
POST/api/v1/portrait/enrollEnroll AI character as a Virtual Portrait (ta_xxx) for Seedance$0.012 / enrollment
GET/api/v1/wallet/{address}/portraitsList a wallet's enrolled Virtual PortraitsFree (rate-limited)
POST/api/v1/realface/initCreate a RealFace enrollment session, returns h5Link for phone liveness checkFree (rate-limited)
POST/api/v1/realface/enrollFinalize RealFace enrollment after H5 completes (uploads face + biometric match)$0.012 / enrollment
GET/api/v1/realface/statusPoll the state of a RealFace enrollment groupFree (rate-limited)
GET/api/v1/wallet/{address}/realfacesList a wallet's enrolled RealFacesFree (rate-limited)

Per-model pricing is published at /api/v1/models and embedded in every 402 response.

Web & Search

MethodPathPurposePricing
POST/api/v1/searchLive search (web / news / X)max_results × $0.025 / source (default 10)
POST/api/v1/exa/searchWeb search$0.012 / call
POST/api/v1/exa/find-similarFind semantically similar pages$0.012 / call
POST/api/v1/exa/answerAI answer with citations$0.012 / call
POST/api/v1/exa/contentsExtract content from URLs$0.002 / URL

Voice & Phone

MethodPathPurposePricing
POST/api/v1/voice/callPlace an outbound AI voice callPer call, returned in 402
GET/api/v1/voice/call/{callId}Poll call status / transcriptFree
GET/POST/api/v1/phone/{path}Phone-number provisioning, lookups, and managementPer endpoint, returned in 402

Sandbox Compute

Ephemeral, isolated Python sandboxes for agent code execution.

MethodPathPurposePricing
POST/api/v1/modal/sandbox/createCreate sandbox$0.012 (flat for short-lived; per-hour for long-lived)
POST/api/v1/modal/sandbox/execExecute a command in a sandbox$0.003
POST/api/v1/modal/sandbox/statusCheck sandbox status$0.003
POST/api/v1/modal/sandbox/terminateTerminate a sandbox$0.003

Prediction Markets (Predexon)

MethodPathPurposePricing
GET/POST/api/v1/pm/{path}Predexon API passthrough — markets, events, odds, historyGET $0.0095 (tier 1) / POST $0.0095 (tier 2)

Crypto Data (Surf)

MethodPathPurposePricing
GET/POST/api/v1/surf/{path}Crypto market / on-chain intelligence — exchanges, on-chain analytics, wallet labels, social mindshare, news, searchTier 1 $0.0095 (reads) · Tier 2 $0.0095 (AI rankings/trends) · Tier 3 $0.0095 (heavy LLM/SQL reports)

0x Swap (DEX)

MethodPathPurposePricing
GET/POST/api/v1/zerox/{path}0x Swap + Gasless aggregation passthrough (price / quote / gasless)Free passthrough — no x402 payment

Financial Data (Pyth-backed)

Real-time and historical prices. All list endpoints are free. Crypto, FX, and commodity price/history are also free; stock price/history (US and non-US) are $0.003/call.

MethodPathPurposePricing
GET/api/v1/usstock/listUS tickersFree
GET/api/v1/usstock/price/{symbol}US stock spot price$0.003
GET/api/v1/usstock/history/{symbol}US stock OHLC$0.003
GET/api/v1/stocks/{market}/listNon-US markets (HK, JP, ...)Free
GET/api/v1/stocks/{market}/price/{symbol}Non-US stock price$0.003
GET/api/v1/stocks/{market}/history/{symbol}Non-US OHLC$0.003
GET/api/v1/crypto/listCrypto tickersFree
GET/api/v1/crypto/price/{symbol}Crypto spotFree
GET/api/v1/crypto/history/{symbol}Crypto OHLCFree
GET/api/v1/fx/listFX pairsFree
GET/api/v1/fx/price/{symbol}FX spotFree
GET/api/v1/fx/history/{symbol}FX OHLCFree
GET/api/v1/commodity/listCommoditiesFree
GET/api/v1/commodity/price/{symbol}Commodity spotFree
GET/api/v1/commodity/history/{symbol}Commodity OHLCFree

Blockchain RPC (Tatum)

Standard JSON-RPC 2.0 to 40+ chains through one endpoint — no API key. EVM (eth_*) and non-EVM methods. See Multi-chain RPC.

MethodPathPurposePricing
POST/api/v1/rpc/{network}Multi-chain JSON-RPC — ethereum, base, solana, polygon, bsc, arbitrum, bitcoin, xrp, sui… (40+, aliases supported)$0.004 / call (batch priced per element)
POST/api/v1/solana/rpcSolana JSON-RPC (also reachable via /api/v1/rpc/solana)Per-method, returned in 402

Free Endpoints

MethodPathPurpose
GET/api/v1/modelsLive chat model catalog with pricing
GET/api/v1/images/modelsImage model list
GET/api/v1/video/modelsVideo model list
GET/api/v1/audio/modelsAudio (music / speech / SFX) model list
GET/api/v1/audio/voicesTTS voice list
GET/api/v1/balanceWallet USDC balance check
GET/api/healthBasic service health
GET/api/v1/health/overviewService health
GET/api/v1/health/chainChain RPC health
GET/api/v1/health/modelsPer-model availability
GET/api/v1/health/regionsRegion/edge health
GET/api/pricingPricing info
GET/.well-known/x402x402 discovery (v1+v2)
GET/openapi.jsonOpenAPI 3.1 spec

Payment Protocol

Every paid endpoint follows the same flow:

  1. Client sends request without payment → server returns HTTP 402 with accepts[] describing network, asset, amount, payTo, and resource URL
  2. Client signs a payment authorization (EIP-3009 on EVM, SPL transfer on Solana, XRPL payment channel on xrpl.blockrun.ai)
  3. Client retries with the PAYMENT-SIGNATURE header (x402 v2)
  4. Server verifies via the network's facilitator, executes the API call, settles onchain
  5. Server returns the response with X-Payment-Receipt (tx hash)

For full details and code samples see Payment Flow. For threat model and non-custodial guarantees see Security.

Source of Truth

This page is human-maintained and may lag a few hours behind code changes. For machine integration:

  • Discovery: GET /.well-known/x402 — canonical resource list, updated per-deploy
  • OpenAPI: GET /openapi.json — full request/response schemas (this is what x402scan reads)
  • Models: GET /api/v1/models — live model catalog with current pricing

Pricing is also embedded in every 402 response, so clients should not hard-code amounts — read them at request time.

Contact

What's next?

Payment Flow

The request, signature, and settlement sequence every endpoint follows.

How x402 Works

Protocol concepts behind the 402 response and on-chain settlement.

Security

The threat model and non-custodial guarantees for paid calls.