xtraderClient/docs/api/priceHistory.md

priceHistory.ts

路径：src/api/priceHistory.ts

功能用途

价格历史公开接口，用于 TradeDetail 页面的 Yes/No 折线图。对接 GET /pmPriceHistory/getPmPriceHistoryPublic（无需鉴权）。

核心能力

• getPmPriceHistoryPublic：按市场 ID 分页获取价格历史
• getTimeRangeSeconds：根据分时范围计算 startTs、endTs（Unix 秒）；endTs 始终为当前时间；1H/6H/1D/1W/1M 的 startTs 为当前时间往前对应时长；ALL 的 startTs 为事件开始时间、endTs 为当前时间
• priceHistoryToChartData：将接口返回的 list 转为 ECharts 使用的 [timestamp_ms, value_0_100][]

GET /pmPriceHistory/getPmPriceHistoryPublic

请求参数（Query）

参数	类型	必填	说明
market	string	是	传 YES 对应的 clobTokenId（即当前市场 clobTokenIds[0]）
page	number	否	页码，默认 1
pageSize	number	否	每页条数，默认 500
startTs	number	否	时间范围起始（Unix 秒）
endTs	number	否	时间范围结束（Unix 秒）
interval	string	否	数据间隔
time	number	否	时间筛选
createdAtRange	string[]	否	创建时间范围
fidelity	number	否	数据精度
keyword	string	否	关键字
order	string	否	排序
sort	string	否	排序字段
price	number	否	价格筛选

响应

{ code, data, msg }，data 为 PageResult<PmPriceHistoryItem>（list、page、pageSize、total）。

PmPriceHistoryItem（list 单项）

字段	类型	说明
ID	number	主键
market	string	市场标识
price	number	价格（0–1 小数或 0–100，由 priceHistoryToChartData 统一为 0–100）
time	number	Unix 秒时间戳
interval	string	数据间隔
fidelity	number	数据精度
createdAt	string	创建时间
updatedAt	string	更新时间

使用方式

import {
  getPmPriceHistoryPublic,
  priceHistoryToChartData,
  getTimeRangeSeconds,
  type PmPriceHistoryItem,
} from '@/api/priceHistory'

const timeRange = getTimeRangeSeconds('1D') // { startTs, endTs }
// ALL 时传 eventDates：getTimeRangeSeconds('ALL', { startDate: ev.startDate, endDate: ev.endDate })
const res = await getPmPriceHistoryPublic({
  market: marketId,
  page: 1,
  pageSize: 500,
  ...(timeRange && { startTs: timeRange.startTs, endTs: timeRange.endTs }),
})
const chartData = priceHistoryToChartData(res.data?.list ?? [])

扩展方式

• 时间戳规则：endTs 始终为当前时间；1H/6H/1D/1W/1M 的 startTs 为当前时间往前对应时长；ALL 的 startTs 为事件 startDate，endTs 为当前时间
• 若后端返回的 price 固定为 0–100，priceHistoryToChartData 已兼容（≤1 时乘 100）