// Crypto market data via Surf — prices, futures, ETFs, options, fear/greed, technical and on-chain indicators, token DEX flows, news, project profiles, VC fund holdings. Use when the user asks about market conditions, ranking tokens, futures positioning, technical signals, options skew, news context, or VC/fund intelligence.
| name | surf-market |
| description | Crypto market data via Surf — prices, futures, ETFs, options, fear/greed, technical and on-chain indicators, token DEX flows, news, project profiles, VC fund holdings. Use when the user asks about market conditions, ranking tokens, futures positioning, technical signals, options skew, news context, or VC/fund intelligence. |
| triggers | ["market overview","fear greed","futures","etf flow","options skew","tokenomics","rsi","macd","liquidations","vc fund","token ranking"] |
| argument-hint | <symbol or question> |
| cost-receipt | true |
You are running inside Franklin on {{wallet_chain}}. Crypto market data lives behind the BlockRun tool, which signs USDC x402 payments from the user's wallet on every call. Pick the cheapest endpoint that answers the question.
Chain note: Surf currently settles x402 payments on Base only (treasury is 0x058a59… on Base). If the user's active chain is solana and you hit a payment error, tell them to switch with /chain base before retrying — the request itself works, the wallet just needs to be on Base to sign the payment.
Call BlockRun({ path: "/v1/surf/<endpoint>", method: "GET", params: { ... } }). All endpoints below are GET unless noted. Required params must be supplied or you'll get a 400 (no charge).
| Path | Tier | Required params | What it returns |
|---|---|---|---|
/v1/surf/exchange/markets | $0.001 | — | Trading pairs catalog across major CEXes |
/v1/surf/exchange/price | $0.001 | pair | Ticker price for a pair |
/v1/surf/exchange/perp | $0.001 | pair | Perpetual contract snapshot |
/v1/surf/exchange/depth | $0.005 | pair | Order book depth |
/v1/surf/exchange/klines | $0.005 | pair | OHLCV candlesticks |
/v1/surf/exchange/funding-history | $0.005 | pair | Perp funding rate history |
/v1/surf/exchange/long-short-ratio | $0.005 | pair | Long/short positioning |
| Path | Tier | Required params | What it returns |
|---|---|---|---|
/v1/surf/market/ranking | $0.001 | — | Token ranking (market cap, volume, change) |
/v1/surf/market/fear-greed | $0.001 | — | Fear & Greed index history |
/v1/surf/market/futures | $0.001 | — | Futures market overview |
/v1/surf/market/price | $0.001 | symbol | Token price history |
/v1/surf/market/etf | $0.001 | symbol | Spot ETF flow history (BTC, ETH) |
/v1/surf/market/options | $0.001 | symbol | Options skew / IV / volume |
/v1/surf/market/liquidation/exchange-list | $0.005 | — | Liquidations by exchange |
/v1/surf/market/liquidation/order | $0.005 | — | Large liquidation orders |
/v1/surf/market/liquidation/chart | $0.005 | symbol | Liquidation chart over time |
/v1/surf/market/onchain-indicator | $0.005 | symbol, metric | NUPL, SOPR, MVRV, Puell, NVT |
/v1/surf/market/price-indicator | $0.005 | indicator, symbol | RSI, MACD, Bollinger, EMA |
| Path | Tier | Required params | What it returns |
|---|---|---|---|
/v1/surf/news/feed | $0.001 | — | AI-curated crypto news feed |
/v1/surf/news/detail | $0.001 | id | Full article by ID |
| Path | Tier | Required params | What it returns |
|---|---|---|---|
/v1/surf/project/detail | $0.001 | — | Aggregated project profile (token + DeFi + social) |
/v1/surf/project/defi/metrics | $0.001 | metric | Per-protocol DeFi metrics (TVL, fees, revenue) |
/v1/surf/project/defi/ranking | $0.001 | metric | DeFi protocol ranking |
| Path | Tier | Required params | What it returns |
|---|---|---|---|
/v1/surf/token/tokenomics | $0.001 | — | Unlock schedule + vesting |
/v1/surf/token/dex-trades | $0.005 | address | DEX trade history |
| Path | Tier | Required params | What it returns |
|---|---|---|---|
/v1/surf/fund/detail | $0.001 | — | VC fund profile |
/v1/surf/fund/portfolio | $0.001 | — | VC fund portfolio holdings |
/v1/surf/fund/ranking | $0.001 | metric | Top VC funds ranking |
market/fear-greed + market/ranking (both $0.001). Cheap snapshot.market/price for history, exchange/price for spot tick, market/etf for institutional flow.market/liquidation/chart for time series, market/liquidation/order for whale events.market/price-indicator with indicator: "RSI" (or MACD, BBANDS, EMA).market/onchain-indicator with metric: "NUPL" etc.token/tokenomics for supply schedule, token/dex-trades for flow.fund/portfolio (filter by project).$ARGUMENTS
Place an outbound AI-driven voice call (Bland.ai via BlockRun). Walks through intent capture, caller-ID selection, task scripting, and confirmation; fires VoiceCall, then auto-polls VoiceStatus until completion and surfaces the transcript. $0.54 per call, US/CA destinations only, charged from your wallet. Real-world action — use with prior consent.
Record market commentary, hypotheses, or open observations as a structured note — no trade fired, no position sized. Lighter than /trade-strategy. Saves to ~/.blockrun/notes/ for future reference. Use when the user wants to think out loud about the market.
Open a paper-trade position with a structured rationale — direction, price target, stop, time horizon, conviction, evidence, tags, thesis. The journal scores the trade on discipline (verifiability, evidence, specificity, novelty, review), not P&L, and surfaces the trend in TradingPortfolio. Use any time the user wants to open a position with intent, not vibes.
Write a long-form trading strategy document — thesis, entry triggers, exit rules, position sizing, hold horizon, kill criteria. No trade is fired. Saves a structured markdown note to ~/.blockrun/notes/. Use when the user wants to plan an approach before committing capital.
On-chain analytics via Surf — raw SQL against 80+ indexed chain tables, structured queries, schema introspection, wallet labels (CEX/Whale/Bridge/MEV…), wallet net worth, transfers, DeFi positions, gas prices, bridge volumes, yield pools. Use when the user wants on-chain forensics, wallet intelligence, holder analysis, transfer tracking, or custom chain queries.
Crypto-Twitter / KOL intelligence via Surf — project mindshare time series, smart-follower history (high-signal accounts), social ranking, tweet + replies fetch, user profile / followers / posts / replies. Use when the user asks about KOL sentiment, project attention, smart money commentary, narrative momentum, or specific Twitter handles.