blockrun_surf
Access unified crypto data including market prices, on-chain SQL, wallet details, prediction markets, and social sentiment through a single API endpoint.
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. |