# BlockRun

> BlockRun is the pay-per-call AI gateway — 55+ models, live data, and code sandbox, settled in USDC from one wallet via the x402 protocol. No API keys, no accounts, no subscriptions.

BlockRun provides pay-per-request access to 55+ large language models (GPT-5, Claude Opus 4.7, Gemini, Grok 4/Imagine, DeepSeek, Kimi K2.6, Llama, Mistral, Cohere, Qwen, and more), image generation (DALL-E 3, ChatGPT Images 2.0 / gpt-image-2, gpt-image-1, Nano Banana, Grok Imagine), video generation (Grok Imagine Video, ByteDance Seedance 1.5 Pro / 2.0 Fast / 2.0 Pro), audio APIs, and real-time data services including neural web search (Exa), prediction markets (Predexon), and sandbox compute (Modal). AI agents pay with USDC on Base, Solana, or XRPL — no subscriptions, no API keys, no vendor lock-in.

## Traction (since Feb 2026)

- 6,000,000+ API calls served
- 1,431+ unique paying wallets
- $31,000+ USDC settled on-chain (Base treasury)
- Live public metrics: https://blockrun.ai/metrics

## Key Products

- [Franklin](https://franklin.run): Flagship agent — the ChatGPT of crypto, driven by BlockRun's gateway.
- [ClawRouter](https://github.com/BlockRunAI/ClawRouter): Open-source LLM router CLI that cuts API costs up to 78% via compression, intelligent routing, and caching. MIT licensed.
- [AI Model Gateway](https://blockrun.ai/models): Access 55+ LLMs from OpenAI, Anthropic, Google, xAI, DeepSeek, Moonshot, Meta, Mistral, Cohere, Alibaba via a single OpenAI-compatible endpoint.
- [Data Marketplace](https://blockrun.ai/partners): Neural web search (Exa), prediction markets (Predexon), sandbox compute (Modal).
- **On-chain Price Feeds** — realtime + historical prices for stocks, crypto, FX, and commodities:
  - **US Stocks** (975+ tickers, **$0.001 USDC per call** via x402): `GET /v1/usstock/price/AAPL`, `GET /v1/usstock/history/AAPL?resolution=D&from=<ts>&to=<ts>`. Sessions: `?session=pre|post|on`. Free list at `/v1/usstock/list`.
  - **Crypto** (500+ pairs, **FREE**): `GET /v1/crypto/price/BTC-USD`, `GET /v1/crypto/history/ETH-USD?resolution=D`. Free list at `/v1/crypto/list`.
  - **FX** (**FREE**): `GET /v1/fx/price/EUR-USD`. Free list at `/v1/fx/list`.
  - **Commodities** (**FREE**): `GET /v1/commodity/price/XAU-USD` (gold), `/v1/commodity/price/XAG-USD` (silver). Free list at `/v1/commodity/list`.
- [Claude Code Plugin / MCP Server](https://blockrun.ai/claude-code-plugin): Use BlockRun services directly from Claude Code, Cursor, and other MCP clients.

## For Developers

- Python SDK: `pip install blockrun-llm`
- TypeScript SDK: `npm install @blockrun/llm`
- Go SDK: `go get github.com/blockrunai/blockrun-llm-go`
- MCP Server: `claude mcp add blockrun --transport http https://mcp.blockrun.ai/mcp`

## How It Works

BlockRun uses the x402 protocol — an HTTP-native payment standard. When an AI agent makes an API request, BlockRun returns a 402 Payment Required response with the price. The agent signs a USDC payment locally (private key never leaves the agent's machine), retries the request with the payment header, and receives the response. Settlement is non-custodial and instant.

## Networks

- Base Mainnet (https://blockrun.ai) — production with real USDC
- Solana Mainnet (https://sol.blockrun.ai) — production with real USDC
- XRPL (https://xrpl.blockrun.ai) — production with real USDC
- Base Sepolia (https://testnet.blockrun.ai) — testnet with test USDC

## Links

- Website: https://blockrun.ai
- Live Metrics: https://blockrun.ai/metrics
- Documentation: https://blockrun.ai/docs
- GitHub: https://github.com/BlockRunAI
- X/Twitter: https://x.com/BlockRunAI
- Pricing: https://blockrun.ai/pricing
- Enterprise: https://blockrun.ai/enterprise
- Franklin agent: https://franklin.run

## Optional

- [llms-full.txt](https://blockrun.ai/llms-full.txt): Detailed version with API reference, model pricing, and SDK examples.