GET获取价格历史

检索特定结果的历史价格数据。Polymarket 兼容格式，使用 Unix 时间戳和可配置的精度。

请求

GET /v1/markets/:id/prices-history

路径参数

参数	类型	必填	描述
`id`	string	是	市场 UUID

查询参数

参数	类型	必填	默认值	描述
`outcomeId`	string	是	—	获取价格历史的结果 ID
`startTs`	number	否	1周前	开始 Unix 时间戳（秒）
`endTs`	number	否	当前时间	结束 Unix 时间戳（秒）
`fidelity`	number	否	`1`	数据精度（分钟）。值越大数据点越少。

响应

{
  "history": [
    { "t": 1710000000, "p": 0.67 },
    { "t": 1710000300, "p": 0.68 },
    { "t": 1710000600, "p": 0.665 }
  ]
}

响应字段

字段	类型	描述
`history`	array	价格点数组
`history[].t`	number	Unix 时间戳（秒）
`history[].p`	number	该间隔的收盘价（0-1）

注意事项

价格数据从已成交和部分成交的订单生成
每个数据点代表精度间隔内的收盘价
更高的精度值会产生更少、更聚合的数据点
使用 fidelity=5 获取5分钟K线，fidelity=60 获取小时K线等

错误

状态码	描述
`400`	缺少 `outcomeId` 或结果不属于此市场
`404`	未找到市场或结果

基于 Slug 的替代方案

如果您使用 WebSocket 信号（提供基于 slug 的频道名称 market:{slug}:price），可以使用基于 slug 的端点，无需维护 slug-to-UUID 映射：

GET /v1/markets/slug/:slug/prices-history

详情请参见通过 Slug 获取价格历史。

示例

最近24小时，5分钟精度

curl "https://api.conviction.bet/v1/markets/550e8400-e29b-41d4-a716-446655440000/prices-history?outcomeId=outcome-uuid-1&startTs=1709913600&endTs=1710000000&fidelity=5"

最近一周，默认精度

curl "https://api.conviction.bet/v1/markets/550e8400-e29b-41d4-a716-446655440000/prices-history?outcomeId=outcome-uuid-1"