Crypto Data

Crypto Data

Four live tools cover crypto data and they overlap. Pick by cost first — two of them are free, and paying for a quote you could get for nothing is the most common mistake here.

A fifth tool, blockrun_surf, was removed in 0.49.0: the gateway has answered every Surf path with HTTP 410 since 2026-09-06. Do not name it; the surf skill maps each former Surf capability to where it lives now — and lists the ones (on-chain SQL, cross-chain wallet labels, social mindshare, CEX order books) that have no BlockRun source yet.

Route by cost — check this before calling anything

Every price below is what x402 actually charges on Base (the base plus the gateway's $0.001 flat fee), verified against live payment-required headers — not the base you may see in a 402 body. The Solana gateway quotes the base alone; the account rail charges no fee.

The rule: a plain crypto price or a DEX pair is free. When the question needs something the four live tools do not have — labels, SQL, social, news, unlocks — tell the user BlockRun does not serve it right now. The tool that used to (blockrun_surf) was removed in 0.49.0.

Prediction markets go to blockrun_markets (Predexon): Polymarket, Kalshi, Limitless, Opinion and Predict.Fun, plus wallet clustering, smart money and UMA. For sports odds use markets/search with { q: "NBA" } or polymarket/events with { search: "NBA" } — the dedicated sports/* routes are degraded upstream, and the bare markets route with a league filter was removed on 2026-08-04 and 404s. Route odds, positions and market history to skills/prediction-markets/SKILL.md.

blockrun_price — quotes & history (Pyth-backed)

Free for crypto, FX and commodities. Equity is catalog-only: since 2026-09-05 the gateway answers stocks price/history with a pre-payment 501 ("We do not currently serve equity prices") — nothing is charged, retrying does not help, and the user should contact hello@blockrun.ai for equity coverage. action:"list" still returns the ticker catalog for free.

blockrun_price({ action: "price",   category: "crypto",    symbol: "BTC-USD" })            // FREE
blockrun_price({ action: "history", category: "crypto",    symbol: "ETH-USD",
                 resolution: "1h", from: 1750000000, to: 1750086400 })                     // FREE
blockrun_price({ action: "price",   category: "fx",        symbol: "EUR-USD" })            // FREE
blockrun_price({ action: "price",   category: "commodity", symbol: "XAU-USD" })            // FREE — gold
blockrun_price({ action: "list",    category: "crypto" })                                  // FREE — discovery
blockrun_price({ action: "list",    category: "stocks",    market: "us", query: "AAPL" })   // FREE — catalog only; price/history → 501

Stock markets: us, hk, jp, kr, gb, de, fr, nl, ie, lu, cn, ca — market is required when category:"stocks". Do not call action:"price" or "history" on stocks: the gateway does not serve equity quotes right now.

blockrun_dex — DEX pairs & liquidity (DexScreener)

Free, no payment. Use it for anything pair- or contract-shaped.

blockrun_dex({ query: "SOL" })                      // search pairs
blockrun_dex({ symbol: "PEPE" })                    // search by symbol
blockrun_dex({ token: "So11111111111111111111111111111111111111112" })  // one token
blockrun_dex({ query: "WETH", chain: "base" })      // scope to a chain

blockrun_defi — TVL & yields (DefiLlama)

Path-based, GET only. Base only in wallet mode; fine on an API key — sol.blockrun.ai does not serve /v1/defillama/* and answers 404, which reads like a bad path rather than a wrong chain. The tool checks the active chain and refuses with that explanation before spending the round trip; if the user needs DeFi data, switch back with blockrun_wallet action:"chain" chain:"base".

blockrun_defi({ path: "protocol/aave-v3" })
blockrun_defi({ path: "chains" })
blockrun_defi({ path: "yields" })                   // big payload — filter after
blockrun_defi({ path: "prices/coingecko:ethereum" })

blockrun_surf — removed 2026-09-06 (tool dropped in 0.49.0)

The gateway answers every /v1/surf/* path with 410 endpoint_retired (verified live 2026-09-08; sol.blockrun.ai 404s; /api/openapi lists no Surf route), so the tool was removed from the server rather than left to return an error. It is not one of the 19 tools. Route former Surf questions to blockrun_price, blockrun_dex, blockrun_defi, blockrun_markets or blockrun_rpc; see skills/surf/SKILL.md for the endpoint-by-endpoint map and for what has no replacement.

blockrun_rpc — raw chain access

blockrun_rpc({ network: "base", method: "eth_blockNumber", params: [] })

Worked Examples

1. "What's BTC at?" — do not pay for this

blockrun_price({ action: "price", category: "crypto", symbol: "BTC-USD" })   // FREE

Not blockrun_surf — it no longer exists (removed in 0.49.0); before 2026-09-06 it charged $0.0085 for an answer you can get free.

2. "Is this token legit?" ← compound, mostly free

blockrun_dex({ token: "0xCONTRACT" })                                        // FREE — liquidity, volume, pairs, age
blockrun_defi({ path: "prices/base:0xCONTRACT" })                            // $0.0020 — is it priced by DefiLlama at all?
blockrun_rpc({ network: "base", method: "eth_call", params: [{ to: "0xCONTRACT", data: "0x18160ddd" }, "latest"] })  // totalSupply()

Start free. Only pay once the free signal says it is worth a closer look. Holder concentration and unlock schedules were Surf features and have no BlockRun source right now — say so rather than guessing.

3. "Who owns this wallet and what do they hold?"

// A Polymarket trader: identity, linked wallets, P&L — via Predexon
blockrun_markets({ path: "polymarket/wallet/identity/0xWHALE" })
blockrun_markets({ path: "polymarket/wallet/0xWHALE/cluster" })
blockrun_markets({ path: "polymarket/wallet/pnl/0xWHALE" })

// Any address: balances via raw RPC
blockrun_rpc({ network: "ethereum", method: "eth_getBalance", params: ["0xWHALE", "latest"] })

Cross-chain labels (CEX / MEV / bridge), net-worth history and DeFi position breakdowns were Surf features; nothing on BlockRun serves them today.

4. "Where's the best yield right now?"

blockrun_defi({ path: "yields" })          // filter by chain/TVL/APY client-side — payload is large
blockrun_defi({ path: "chains" })          // where the money actually is

5. "Give me the macro picture"

blockrun_price({ action: "price", category: "crypto",    symbol: "BTC-USD" })   // FREE
blockrun_price({ action: "price", category: "commodity", symbol: "XAU-USD" })   // FREE — gold
blockrun_price({ action: "price", category: "fx",        symbol: "EUR-USD" })   // FREE
blockrun_defi({ path: "chains" })                                               // $0.0060 — where DeFi capital sits
blockrun_markets({ path: "markets/search", params: { q: "bitcoin", status: "open" } })  // $0.0085 — what the crowd is pricing

ETF flows, funding rates, liquidation charts and the Fear & Greed index were Surf features with no BlockRun source today.

6. "Is gold up today?" — also free

blockrun_price({ action: "price", category: "commodity", symbol: "XAU-USD" })   // FREE

Related

• Prediction markets (odds, smart money, wallet clustering) → skills/prediction-markets/SKILL.md
• Polymarket trading (real money) → skills/polymarket-trading/SKILL.md
• Surf is retired — what replaced each former endpoint → skills/surf/SKILL.md
• Raw RPC → skills/rpc/SKILL.md