BlockRun
MARKETPLACE/TRADING MARKETS

Every market. One wallet.

Realtime quotes + historical OHLC bars for 1,746+ equities across 12 markets, plus crypto, FX, and commodities — all through a single HTTP call paid in USDC on Base. No API keys, no accounts, no subscriptions.

View docs

WHAT WE COVER

1,746+ equities · 500+ crypto · 30+ FX · 10+ commodities

12
Stock markets
US · JP · GB · KR · HK · DE · FR · NL · IE · LU · CN · CA
1,746+
Equity tickers
NYSE, Nasdaq, TSE, LSE, KRX, HKEX, XETRA, Euronext, AEX, ISE, TSX
500+
Crypto pairs
BTC, ETH, SOL, and every major altcoin
~400ms
Oracle cadence
Every quote ships with ±confidence bars

STOCK MARKETS

12 markets, 1 endpoint pattern

🇺🇸
United States
NYSE · Nasdaq · AMEX
1119
tickers
GET /v1/stocks/us/price/AAPL→ live quote for Apple
Browse 1119 tickers $0.001 / call
🇯🇵
Japan
Tokyo Stock Exchange
234
tickers
GET /v1/stocks/jp/price/7203→ live quote for Toyota
Browse 234 tickers $0.001 / call
🇬🇧
United Kingdom
London Stock Exchange
107
tickers
GET /v1/stocks/gb/price/HSBA→ live quote for HSBC
Browse 107 tickers $0.001 / call
🇰🇷
South Korea
KRX · KOSPI · KOSDAQ
100
tickers
GET /v1/stocks/kr/price/005930→ live quote for Samsung Electronics
Browse 100 tickers $0.001 / call
🇭🇰
Hong Kong
HKEX
96
tickers
GET /v1/stocks/hk/price/0005-HK→ live quote for HSBC
Browse 96 tickers $0.001 / call
🇩🇪
Germany
XETRA · Frankfurt
39
tickers
GET /v1/stocks/de/price/SAP→ live quote for SAP
Browse 39 tickers $0.001 / call
🇫🇷
France
Euronext Paris
37
tickers
GET /v1/stocks/fr/price/MC→ live quote for LVMH
Browse 37 tickers $0.001 / call
🇳🇱 🇮🇪 🇱🇺 🇨🇳 🇨🇦
Others
Netherlands · Ireland · Luxembourg · China · Canada
14
tickers
🇳🇱nl(5)
AIR, STLAP, STMPA, QIA, BCOIN
🇮🇪ie(4)
VUSA, VUSD, CSP1, EUE
🇱🇺lu(2)
MT, ERF
🇨🇳cn(2)
510310, 510330
🇨🇦ca(1)
HODL
GET /v1/stocks/{nl,ie,lu,cn,ca}/price/{symbol}$0.001 / call

OTHER ASSETS — FREE

Crypto, FX, and commodities — no payment required

Crypto
Free

500+ pairs incl. BTC, ETH, SOL, stablecoins

/v1/crypto/price/BTC-USD
FX
Free

30+ major + minor currency pairs

/v1/fx/price/EUR-USD
Commodities
Free

Gold, silver, platinum, crude oil, natural gas

/v1/commodity/price/XAU-USD

Examples

Free — live Bitcoin price:

$ curl https://blockrun.ai/api/v1/crypto/price/BTC-USD
{
  "symbol": "BTC-USD",
  "price": 75923.44,
  "confidence": 25.46,
  "timestamp": "2026-04-21T05:12:00.000Z",
  "free": true
}

Paid — live HSBC (Hong Kong) price:

$ curl https://blockrun.ai/api/v1/stocks/hk/price/0005-HK
# 402 Payment Required — send x-payment header with $0.001 USDC.
# With BlockRun SDKs the payment flow is automatic.

$ pip install blockrun-llm
>>> from blockrun_llm import client
>>> client.stocks("hk", "0005-HK")
{ symbol: "0005-HK", price: 98.40, currency: "HKD", ... }

THREE WAYS TO USE THIS

Pick the surface that fits your stack

Every endpoint above sits behind BlockRun's x402 gateway. Franklin Agent, ClawRouter, and the MCP server all wrap that same gateway — with wallet, payment, and retries handled for you.

FLAGSHIP AGENT

Franklin Agent

The AI agent with a wallet. Ask in plain English — it pays the $0.001 and streams the quote back.

> What's Toyota (7203) trading at?
→ live quote · conf ±0.4 · 12s ago
Try Franklin Agent Learn more
SDK · OPEN SOURCE

ClawRouter

Drop into Python or TypeScript. The SDK signs x402 headers, pays in USDC, retries on failure — you just call the endpoint.

$ pip install blockrun-llm
>>> from blockrun_llm import Client
>>> c = Client()  # auto-loads wallet
>>> c.get("/v1/stocks/jp/price/7203")
Install ClawRouter npm / pypi
CLAUDE CODE · CURSOR · CHATGPT

BlockRun MCP

One install plugs every BlockRun service — including live quotes — into your AI assistant as callable tools.

$ claude mcp add blockrun -s user -- \
    npx -y @blockrun/mcp@latest
Setup guide GitHub

Or go raw HTTP

Point any x402-compatible HTTP client at the endpoints above. The 402 response carries a full bazaar schema, so any agent can discover and call it without reading these docs.

Open docs