查看单个 Polymarket 市场成交量历史
如何使用这个 Tool
使用下列已部署输入字段。必填字段必须提供;可选筛选用于缩小结果范围。
queryParams.end_time (可选): 结束时间,Unix 秒(与 time_range 二选一)。
queryParams.interval (可选): 返回序列中每个数据点的时间桶大小:1h(每小时)或 1d(每天)。它不同于 time_range,后者决定时间窗口。示例:1d。默认值:1d。
queryParams.token_id (可选): Token ID(备用标识符,内部会解析为 condition_id)。
queryParams.start_time (可选): 开始时间,Unix 秒(与 time_range 二选一)。
queryParams.time_range (可选): 要返回的历史窗口(从现在向前追溯):7d、30d、90d、180d 或 1y。它不同于 interval,后者决定窗口内的分桶大小。示例:30d。默认值:30d。
queryParams.granularity (可选): 聚合粒度(interval 的替代参数)。提供后会查询包含买入/卖出交易量拆分的日表。
queryParams.condition_id (可选): 市场 condition 标识符(未提供 token_id 时必填)。示例:0x6fefc0438c7598b23531457c8c60541990d0786bd4bd9dfc3eabc8d95c291092。
返回内容
返回时间分桶的名义美元成交量、可用买卖拆分和成交次数。
返回字段与解读方式
下表按照官方响应合同列出嵌套字段和有用的响应元数据。[] 表示数组中的一项。“父对象内必填”不代表有条件的父对象一定存在。类型允许 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 客户费用。
可继续使用的能力: 使用已查到的市场标识获取 Polymarket 市场