验证只读链上 SQL 查询而不执行查询
如何使用这个 Tool
使用下列已部署输入字段。必填字段必须提供;可选筛选用于缩小结果范围。
body.sql (必填): 要校验和估算的只读 ClickHouse SELECT/WITH 查询,不会实际执行。格式和规则与 /onchain/sql 相同。只允许 SELECT/WITH;表名必须带数据库前缀,使用 agent.<table>。必须按分区键 block_date 或 block_number 筛选,否则会超时。地址列应直接与小写字面量比较,不能用 lower() 包住列名。不要按 symbol 列筛选,这会触发无索引全表扫描,并可能匹配到仿冒代币;请先通过 /search/token 将代币代码解析为合约地址。查询转账表时,应使用独立的 UNION ALL 分支,而不是用 OR 连接 from/to 条件。字符串使用单引号,例如 toDate('2026-04-07')。
body.max_rows (可选): 最多返回的行数,服务端默认 1000,上限为 10000。示例:100。
返回内容
返回查询是否接受、改写 SQL、扫描估算、扫描预算、引用表和警告,不执行查询。
返回字段与解读方式
下表按照官方响应合同列出嵌套字段和有用的响应元数据。[] 表示数组中的一项。“父对象内必填”不代表有条件的父对象一定存在。类型允许 null 时可返回空值;可选字段可以省略。请结合各字段的明确条件区分缺失、空集合和数值 0。只有明确说明时才能确认单位与统计窗口。
覆盖范围、单位与时效
预检查接受和估算不代表查询已执行或返回数据。应展示警告与明确扫描上限。
按字段说明检查返回的观测时间、缓存状态、水位、分页和错误。请求成功本身不能证明覆盖完整;来源没有说明时效或完整性保证时,应视为未知。保存的 Example 是历史样本,查看不会刷新数据或执行新调用。
数据来源与引用
此接口的数据由 Surf Data API 提供。响应合同和已部署 Tool 输入于 2026-10-03 按官方 OpenAPI v0.2.102 核对。此日期是合同核对日期,不是数据观测时间。实际覆盖取决于所选接口和请求。
Surf Data API 官方文档
Surf 官方 OpenAPI 合同
通过一个 Toolmu 账号,使用可用工具之间共享的预付费余额。按次付费,无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0288 Toolmu 积分。这是上限,不是已结算费用。执行前应获取最新 Tool 契约,核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used(如有)表示来源 API 积分,不是 Toolmu 客户费用。
可继续使用的能力: 查看链上数据表、字段与可选物理来源信息