blockrun_surf
Access 83 unified crypto endpoints via Surf: get CEX prices, on-chain SQL across 13 chains, wallet labels, and prediction market data in one call. Query market prices, search web, or run raw SQL without API keys.
Instructions
Unified crypto data via Surf (asksurf.ai) — 83 endpoints, one API.
Coverage: CEX market data (16 exchanges), on-chain SQL across 13 chains, 100M+ labeled wallets, prediction markets (Polymarket + Kalshi), social mindshare / CT intelligence, news, and unified search.
Pricing (settled in USDC to Surf's Base treasury):
Flat $0.0095/call — every endpoint, including raw on-chain SQL. No tiers. ($0.0075 base + $0.002 tx fee.)
Common paths (full 83-endpoint catalog in the surf skill):
market/price?symbol=BTC
exchange/price?pair=BTC-USDT
prediction-market/polymarket/ranking
search/web?q=ethereum+pectra+upgrade
wallet/detail?address=0x...
social/mindshare?q=ethereum&interval=1d
onchain/sql + body:{ sql: "SELECT ..." }
Method is auto-routed: pass 'body' for POST endpoints; otherwise GET with 'params'. Each Surf endpoint pre-validates required params before settling — you get a 400 (not a charge) if a required field is missing. Browse the full catalog: https://blockrun.ai/marketplace/surf
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | JSON body for POST endpoints. Provide for: onchain/query, onchain/sql. When set, the call is sent as POST; otherwise GET with params. | |
| path | Yes | Endpoint path under /v1/surf/, e.g. 'market/price', 'prediction-market/polymarket/ranking', 'wallet/detail', 'onchain/sql' | |
| params | No | Query parameters for GET endpoints, e.g. { symbol: 'BTC' } or { address: '0x...', chain: 'ethereum' } | |
| agent_id | No | Agent identifier for budget tracking and enforcement. |