xtraderClient/docs/api/historyRecord.md

historyRecord.ts

路径：src/api/historyRecord.ts

功能用途

历史记录接口，用于 Wallet 页「History」Tab。Wallet 使用 GET /hr/getHistoryRecordListClient（需鉴权、按当前用户分页）；另提供 GET /hr/getHistoryRecordPublic（不需要鉴权）备用。

核心能力

• getHistoryRecordListClient：客户端分页获取历史记录（需鉴权，传 userId、page、pageSize）
• getHistoryRecordPublic：分页获取历史记录（无需鉴权）
• getHistoryRecordList：从响应 data 中解析 list 并映射为 HistoryDisplayItem[]，同时返回 total
• mapHistoryRecordToDisplayItem：单条 HistoryRecordItem → 钱包展示项（与 Wallet.vue HistoryItem 一致）

GET /hr/getHistoryRecordListClient（Wallet 使用）

需鉴权：x-token、x-user-id。

请求参数（Query）

参数	类型	说明
page	number	页码
pageSize	number	每页条数
userId	number	用户 ID
keyword	string	关键字
slug	string	标识
title	string	标题
name	string	名称
bio	string	简介
createdAtRange	string[]	创建时间范围

响应

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

GET /hr/getHistoryRecordPublic

请求参数（Query，可选）

参数	类型	说明
page	number	页码
pageSize	number	每页条数
keyword	string	关键字
slug	string	标识
title	string	标题
name	string	名称
bio	string	简介
createdAtRange	string[]	创建时间范围

响应

{ code, data, msg }。data 可能为 PageResult<HistoryRecordItem>（list、page、pageSize、total）或 HistoryRecordItem[]。

HistoryRecordItem（与 doc.json polymarket.HistoryRecord 对齐）

字段	类型	说明
ID	number	主键
title	string	标题（如「充值资金」）
type	string	类型（如 recharge）
usdcSize	number	金额（USDC），用于充值等
icon	string	图标路径（如 uploads/file/btc.png），会转为完整 URL 展示
UpdatedAt	string	更新时间，用于 timeAgo 展示
price	number	价格
size	number	大小
outcome	string	结果
timestamp	number	时间戳（秒或毫秒）
其他	-	asset, bio, conditionId, slug, transactionHash 等

使用方式

import { getHistoryRecordPublic, getHistoryRecordList } from '@/api/historyRecord'

const res = await getHistoryRecordPublic({ page: 1, pageSize: 10 })
const { list, total } = getHistoryRecordList(res.data)
// list 为 HistoryDisplayItem[]，可直接用于 Wallet 历史列表

扩展方式

• 若后端固定返回分页结构，可收紧 HistoryRecordPublicResponse['data'] 类型为 PageResult<HistoryRecordItem>
• 展示字段（market、activity、value、timeAgo 等）可在 mapHistoryRecordToDisplayItem 中按实际接口字段再调整