The Discovery Layer for AI Agent Payments
BlockRun is the payment rail for AI — a service marketplace where AI agents autonomously discover, route, and pay for APIs using USDC via the x402 protocol. BlockRun provides pay-per-request access to 40+ large language models (including GPT-5, Claude, Gemini, Grok, DeepSeek, and Kimi), image generation, real-time web search, X/Twitter intelligence, and prediction market data. No API keys, no subscriptions, no vendor lock-in.
- Quick Start
- API Products
- Supported Models
- Networks
- SDKs
- MCP Tools
- Smart Routing
- Framework Integrations
- Projects Built with BlockRun
- Ecosystem
- Research
- Vision
- Community
from blockrun_llm import LLMClient
client = LLMClient(private_key="0x...")
# Chat with any model — payment handled via x402
response = client.chat("Hello!")
# Smart routing — auto-picks cheapest capable model
response = client.smart_chat("Summarize this article", profile="eco")
# Image generation
from blockrun_llm import ImageClient
img = ImageClient(private_key="0x...")
result = img.generate("A cyberpunk city at sunset", model="openai/gpt-image-1")
# Real-time search (web, news)
results = client.search("latest AI agent frameworks")import { LLMClient, ImageClient } from 'blockrun-llm';
const client = new LLMClient({ privateKey: '0x...' });
// Chat with any model
const response = await client.chat('Hello!');
// Smart routing
const smart = await client.smartChat('Summarize this', { profile: 'eco' });
BlockRun is a unified API gateway — pay per request with USDC, no API keys needed.
| Product | Endpoint | Pricing | Description |
|---|---|---|---|
| LLM Chat | /v1/chat/completions |
Per token | OpenAI-compatible, 40+ models, streaming, tool calling |
| Image Generation | /v1/images/generations |
$0.02–0.15/image | DALL-E 3, GPT Image 1, Nano Banana, Nano Banana Pro |
| Image Editing | /v1/images/image2image |
Per request | AI-powered inpainting and image-to-image |
| Search | /v1/search |
$0.025/source | Real-time search across web, news, RSS |
| X/Twitter Data | /v1/x/* |
Coming Soon | User profiles, tweets, followers, search, trending, analytics |
| Prediction Markets | /v1/pm/* |
$0.001–0.005 | Polymarket, Kalshi, dFlow, Binance Futures |
| Models | /v1/models |
Free | List all available models with pricing |
| Pricing | /v1/pricing |
Free | Detailed pricing for all models |
| Balance | /v1/balance |
Free | Check USDC wallet balance |
Real-time X/Twitter data — user profiles, tweets, followers, search, trending topics, and analytics. Pending partnership agreement with X.
Real-time prediction market data powered by Predexon:
| Market | Endpoints | Price |
|---|---|---|
| Polymarket | Markets, events, trades, orderbooks, leaderboards, positions | $0.001–0.005 |
| Kalshi | Markets, trades, orderbooks | $0.001 |
| dFlow | Trades, positions, P&L | $0.001–0.005 |
| Binance Futures | Candles, ticks | $0.005 |
40+ models across 10 providers. All accessible through a single OpenAI-compatible API.
| Provider | Models | Input/Output per 1M tokens |
|---|---|---|
| OpenAI | GPT-5.4, GPT-5.4 Pro, GPT-5.3, GPT-5.3 Codex, GPT-5.2, GPT-5 Mini, GPT-5 Nano | $0.05–$30.00 / $0.40–$180.00 |
| Anthropic | Claude Opus 4.6, Claude Sonnet 4.6, Claude Haiku 4.5 | $1.00–$5.00 / $5.00–$25.00 |
| Gemini 3.1 Pro, Gemini 3 Pro, Gemini 3 Flash, Gemini 2.5 Pro, Gemini 2.5 Flash, Gemini 2.5 Flash Lite | $0.10–$2.00 / $0.40–$12.00 | |
| DeepSeek | DeepSeek Chat (V3.2), DeepSeek Reasoner (V3.2 thinking) | $0.28 / $0.42 |
| xAI | Grok 4.1 Fast, Grok Code Fast 1, Grok 4, Grok 2 Vision | $0.20–$3.00 / $0.50–$15.00 |
| Z.AI | GLM-5, GLM-5 Turbo, GLM-5 Code | $1.00–$1.20 / $3.20–$5.00 |
| Moonshot | Kimi K2.5 (262K context, MoE) | $0.60 / $3.00 |
| MiniMax | MiniMax M2.7 (204K context, reasoning) | $0.30 / $1.20 |
| NVIDIA | GPT-OSS 120B, GPT-OSS 20B | Free |
| Model | Price (input/output per 1M) |
|---|---|
| OpenAI o1 | $15.00 / $60.00 |
| OpenAI o3 | $2.00 / $8.00 |
| OpenAI o1-mini, o3-mini | $1.10 / $4.40 |
| DeepSeek Reasoner | $0.28 / $0.42 |
| Model | Price per image |
|---|---|
| OpenAI GPT Image 1 | $0.02–0.04 |
| OpenAI DALL-E 3 | $0.04–0.08 |
| Nano Banana | $0.05 |
| Nano Banana Pro | $0.10–0.15 |
Full pricing:
GET /v1/pricingor see Pricing docs
BlockRun runs on two networks with separate gateways:
| Network | Gateway | Asset | Status |
|---|---|---|---|
| Base | blockrun.ai |
USDC | ✅ Live |
| Solana | sol.blockrun.ai |
USDC | ✅ Live |
| Base Sepolia | testnet.blockrun.ai |
USDC (testnet) | ✅ Testnet |
| Solana Devnet | devnet-sol.blockrun.ai |
USDC (devnet) | ✅ Testnet |
Payment protocol: x402 (HTTP 402 "Payment Required") — wallet signs payment, no accounts or API keys needed.
| Language | Install | Features | Repository |
|---|---|---|---|
 |
pip install blockrun-llm |
Chat, Images, Search, Prediction Markets, Smart Routing, Solana | GitHub |
 |
npm i blockrun-llm |
Chat, Images, Search, OpenAI-compatible drop-in, Smart Routing, Solana | GitHub |
 |
go get github.com/blockrunai/blockrun-llm-go |
Chat | GitHub |
from blockrun_llm import SolanaLLMClient
client = SolanaLLMClient(private_key="your-solana-private-key")
response = client.chat("Hello from Solana!")
# Pays with USDC on Solana via x402pip install blockrun-llm[solana]| Tool | Description |
|---|---|
| blockrun-mcp | MCP Server for Claude Code — Chat (40+ models), Images, DEX data, Whale tracking, Trading signals, Token swaps |
9 tools included: blockrun_chat, blockrun_image, blockrun_models, blockrun_wallet, blockrun_dex, blockrun_whale, blockrun_analyze, blockrun_signal, blockrun_swap
claude mcp add blockrun npx @blockrun/mcpClawRouter — routes to the cheapest capable model in <1ms, 100% local, no API calls.
| Profile | Strategy | Example Models |
|---|---|---|
free |
Free models only | NVIDIA GPT-OSS 120B/20B |
eco |
Cheapest capable | DeepSeek, Gemini Flash Lite |
auto |
Balanced cost/quality | GPT-5 Mini, Gemini Flash |
premium |
Best quality | Claude Opus 4.6, GPT-5.4 |
Built into both Python and TypeScript SDKs. Also available as standalone: ClawRouter
| Framework | Status | Integration |
|---|---|---|
| OpenClaw | ✅ Released | ClawRouter - Smart LLM router, 78% cost savings |
| ElizaOS | ✅ Released | elizaos-plugin-blockrun |
| Claude Code | ✅ Released | blockrun-mcp |
| GOAT SDK | 🔄 In Review | Agent framework integration |
| AgentKit | 📋 Planned | Coinbase agent framework |
| LangChain | 📋 Planned | Custom LLM provider |
| Project | Category | Description |
|---|---|---|
| PredictOS | Prediction Markets | Prediction market analysis platform with multi-AI provider support |
| Polymarket AI Agent | Prediction Markets | Autonomous AI trading agent using 3-model LLM consensus |
| LLM_trader | Crypto Trading | AI crypto trading bot with multi-provider support and chart analysis |
| Spraay | x402 Gateway | Multi-chain x402 payment gateway with dual-provider AI inference (BlockRun + OpenRouter) |
| NoFx | Crypto Trading | Personal AI trading assistant - any market, any model, pay with USDC |
| Voyage GEO | AI Analytics | Generative Engine Optimization - track how AI models reference your brand across ChatGPT, Claude, Gemini & more |
Built something with BlockRun? Add it here!
| Partner | Description |
|---|---|
 |
Official Circle Alliance Partner powering USDC payments on Base |
| Partner | Product | Description |
|---|---|---|
| Predexon | Prediction Markets | Polymarket, Kalshi, dFlow, Binance Futures data |
BlockRun aggregates services from the x402 facilitator network:
| Facilitator | Network |
|---|---|
| Coinbase CDP | Base, Ethereum |
| PayAI | Base, Solana |
| thirdweb | Base, Ethereum |
| QuestFlow | Base |
| AnySpend | Base |
| AurraCloud | Base |
| Partner | Relationship |
|---|---|
| x402 Foundation | Protocol development |
See ECOSYSTEM.md for full partner directory.
| Format | Link |
|---|---|
| Full Report (PDF) | State of x402 2025 |
| Web Version | Markdown |
| Presentation | Deck |
Key Findings:
- Average transaction: $0.12 (true micropayments impossible on traditional rails)
- 53% of volume is organic business activity
- Base dominates with 53.3% of services, Solana at 36.6%
- 76% of services priced at $0.10 or below
See research/ for methodology.
AI agents can't pay for services. Traditional payment rails require account creation, credit cards, and KYC verification - none of which agents can do.
But agents have something better: wallets.
The x402 protocol (HTTP 402 "Payment Required") lets any HTTP request include a cryptographic payment. Pay and get response. One step.
| Phase | Timeline | Focus |
|---|---|---|
| LLM Gateway | Now | Pay-per-request access to 40+ AI models |
| Premium Data | Now | Prediction markets, web search, image generation |
| X/Twitter Intelligence | Coming Soon | Real-time X/Twitter data (pending X partnership) |
| Multi-Chain | Now | Base + Solana gateways live |
| Trust | Q1 2026 | Service ratings, uptime tracking, smart routing |
See VISION.md | ROADMAP.md for full details.
| Area | What You Can Do |
|---|---|
| Code | Add features, fix bugs, improve SDKs |
| Docs | Improve documentation, add examples |
| Integrations | Build plugins for agent frameworks |
| Feedback | Report bugs, request features |
All contributors will be recognized in ACKNOWLEDGMENTS.md.
See CONTRIBUTING.md for guidelines.
| Section | Links |
|---|---|
| Getting Started | Claude Code • Agent Developers • SDK Developers • Wallet Setup |
| API Reference | Chat Completions • Images • Search • X/Twitter • Prediction Markets • Models • Errors |
| x402 Protocol | How It Works • Payment Flow • Security |
| Resources | Pricing • FAQ • Changelog |
BlockRun is the payment rail for AI — a service marketplace where AI agents discover, route, and pay for APIs using USDC via the x402 protocol. It provides access to 40+ LLMs, image generation, web search, and data APIs without requiring API keys or subscriptions.
AI agents pay using the x402 protocol — an HTTP-native payment standard. When an agent makes a request, BlockRun returns HTTP 402 with the price. The agent signs a USDC payment locally (private key never leaves the machine), retries with the payment header, and receives the response. Settlement is non-custodial and instant on Base or Solana.
ClawRouter is an open-source (MIT licensed) smart LLM router built for autonomous agents. It analyzes each request across 15 dimensions and routes to the cheapest capable model in under 1ms, entirely locally. ClawRouter can reduce LLM API costs by up to 92% compared to using premium models directly.
BlockRun is agent-native — it uses wallet signatures for authentication instead of API keys, and USDC micropayments instead of credit cards. This means AI agents can operate autonomously without human intervention. BlockRun also includes ClawRouter for smart routing, a data marketplace, and multi-chain support (Base + Solana).
The x402 protocol is an HTTP-native payment standard based on HTTP status code 402 ("Payment Required"). It allows any HTTP request to include a cryptographic USDC payment, enabling machine-to-machine payments without accounts, credit cards, or KYC verification. BlockRun is a leading implementation of x402.
BlockRun uses pay-per-request pricing with no minimums or subscriptions. Prices start at $0.0002 per request for budget models. Provider cost plus 30% margin. $5 in USDC is enough for thousands of requests.
Brand Kit · Website · Twitter · Telegram
BlockRun: Let AI agents pay for AI.