统计 DEX 项目或路由合约的链上活动
如何使用这个 Tool
使用下列已部署输入字段。必填字段必须提供;可选筛选用于缩小结果范围。
queryParams.to (可选): 结束时间,使用 Unix 秒级时间戳或 YYYY-MM-DD。未填写 from 时,查询截至 to、长度为 time_range 的时间段。示例:2025-02-01。
queryParams.from (可选): 开始时间,使用 Unix 秒级时间戳或 YYYY-MM-DD。与 to 同时填写时,时间跨度不得超过 90 天。示例:2025-01-01。
queryParams.chain (必填): 要查询的区块链。示例:ethereum。
queryParams.address (可选): 按 tx_to 统计的路由器或合约地址。project 和 address 必须且只能填写一个。示例:0x1111111254eeb25477b68fb85ed929f73a960582。
queryParams.project (可选): 去中心化交易所的项目名称,例如 uniswap、pancakeswap 或 aerodrome。project 和 address 必须且只能填写一个。示例:uniswap。
queryParams.group_by (可选): 分组方式:total 返回一条汇总结果;day 返回按日排列的数据,日期从新到旧。默认 total。
queryParams.time_range (可选): 向前查询的时间范围,最长 90 天,默认 7d。填写 from/to 后以这两个参数为准。
返回内容
返回时间分桶的已记录成交数、活跃交易者、美元成交量和价格补全覆盖率。
返回字段与解读方式
下表按照官方响应合同列出嵌套字段和有用的响应元数据。[] 表示数组中的一项。“父对象内必填”不代表有条件的父对象一定存在。类型允许 null 时可返回空值;可选字段可以省略。请结合各字段的明确条件区分缺失、空集合和数值 0。只有明确说明时才能确认单位与统计窗口。
覆盖范围、单位与时效
链上数据按日更新,美元价格补全可能滞后。应通过 enriched_ratio 判断金额统计是否完整。
按字段说明检查返回的观测时间、缓存状态、水位、分页和错误。请求成功本身不能证明覆盖完整;来源没有说明时效或完整性保证时,应视为未知。保存的 Example 是历史样本,查看不会刷新数据或执行新调用。
数据来源与引用
此接口的数据由 Surf Data API 提供。响应合同和已部署 Tool 输入于 2026-10-03 按官方 OpenAPI v0.2.102 核对。此日期是合同核对日期,不是数据观测时间。实际覆盖取决于所选接口和请求。
Surf Data API 官方文档
Surf 官方 OpenAPI 合同
通过一个 Toolmu 账号,使用可用工具之间共享的预付费余额。按次付费,无需单独订阅供应商。此 Tool 当前每次执行费用上限为 0.0144 Toolmu 积分。这是上限,不是已结算费用。执行前应获取最新 Tool 契约,核对可用性、最新 maximumCredits、余额和预算。响应中的 credits_used(如有)表示来源 API 积分,不是 Toolmu 客户费用。