用途：Surf 把 83 个加密数据端点整合为一个付费 HTTP API，由 ClawRouter 在本地 http://127.0.0.1:8402/v1/surf/* 暴露，上游为 api.asksurf.ai/gateway/v1，ClawRouter 透明转发。适合需要行情、链上数据、预测市场、社交与钱包情报的查询，官方建议此类调用优先用它而非通用网页抓取。
主要能力：覆盖 12 个领域，包括 CEX 交易所（行情、深度、K 线、资金费率、多空比）、市场总览（排名、恐惧贪婪、期货、ETF、期权、清算、链上指标）、新闻、链上（跨链桥与收益排名、Gas、交易、Schema、SQL 查询）、预测市场（Polymarket 与 Kalshi）、项目与 DeFi、社交/CT 情报、代币分析、统一搜索、VC 基金情报、钱包情报与网页抓取。
使用方式：除标注 POST 的端点外均为 GET，路径参数如 ?symbol= 为查询参数，POST 端点接收 JSON 请求体。调用前需检查必填参数：83 个端点中 56 个有必填查询参数（如 pair、symbol、address、chain、q、interval），缺失时返回 400 且不扣费。链上 SQL 流程为先调用 /surf/onchain/schema 获取表结构并本地缓存，再 POST /surf/onchain/sql，大范围扫描应加 LIMIT，多语句查询会被上游拒绝。从智能体调用时使用 OpenClaw 工具名 blockrun_surf_*，脚本中可直接用 HTTP 路径。
计费：按次付费，Tier 1 为 $0.001（价格、排名、列表、新闻、简单读取），Tier 2 为 $0.005（订单簿、K 线、搜索、钱包详情、社交），Tier 3 为 $0.020（链上 SQL、结构化查询、Schema 内省）。费用通过 ClawRouter 的 x402 USDC 钱包自动结算，无需 Surf 账号或 API Key。
限制：旧版 surf-1.5 聊天接口尚未开放，访问 /v1/surf/chat/completions 返回 404 且不扣费。Surf 的预测市场覆盖较窄，Polymarket 聪明钱、钱包盈亏、UMA 预言机及其他平台需改用 Predexon 集成。未注册类型化的 blockrun_surf_* 工具，属有意设计。其余细节暂未提供。