平仓历史

GET/api/v1/px/position-historyBearer

PX 发现与账户一律 E6 十进制字符串A | B

当前恒返回空数组：平仓历史读模型尚未建设。端点已按最终契约形状对外，接上数据源后字段不变——现在不要把空数组读成「此账户没有平仓过」。

请求头 Authorization: Bearer <token>。token 由 POST /api/v1/auth/verify 签发，24h 空闲或签发满 7d 后失效。

响应

200平仓历史（当前恒空）

historyobject(PxPositionHistoryItem)[]
平仓历史。当前恒为空数组，不要读成「没有平仓过」
historyIdstring
记录 id
示例"history_01K5H2M3N7"
marketSlugstring可为空
市场 slug
questionstring可为空
市场问题
示例"Will BTC clos…c 31, 2026?"
outcomestring可为空
方向，A 或 B
outcomeLabelstring可为空
该侧展示文案
quantityE6string可为空
平仓数量，E6 字符串
avgEntryE6string可为空
平均开仓价，E6 字符串
avgExitE6string可为空
平均平仓价，E6 字符串
initialMarginE6string可为空
初始保证金，E6 字符串
borrowedE6string可为空
借入本金，E6 字符串
realizedPnlE6string可为空
已实现盈亏，E6 字符串
closeReasonstring可为空
平仓原因
resolutionstring可为空
裁决结果

在响应示例中切换状态码查看错误响应，完整错误码见错误码页。

请求

curl -X GET "$BASE_URL/api/v1/px/position-history" \
  -H "Authorization: Bearer $TOKEN"

响应

平仓历史（当前恒空）

{
  "history": [
    {
      "historyId": "history_01K5H2M3N7",
      "marketSlug": null,
      "question": "Will BTC close above $120,000 on Dec 31, 2026?",
      "outcome": null,
      "outcomeLabel": null,
      "quantityE6": null,
      "avgEntryE6": null,
      "avgExitE6": null,
      "initialMarginE6": null,
      "borrowedE6": null,
      "realizedPnlE6": null,
      "closeReason": null,
      "resolution": null
    }
  ]
}

响应

200平仓历史（当前恒空）

historyobject(PxPositionHistoryItem)[]
平仓历史。当前恒为空数组，不要读成「没有平仓过」
historyIdstring
记录 id
示例"history_01K5H2M3N7"
marketSlugstring可为空
市场 slug
questionstring可为空
市场问题
示例"Will BTC clos…c 31, 2026?"
outcomestring可为空
方向，A 或 B
outcomeLabelstring可为空
该侧展示文案
quantityE6string可为空
平仓数量，E6 字符串
avgEntryE6string可为空
平均开仓价，E6 字符串
avgExitE6string可为空
平均平仓价，E6 字符串
initialMarginE6string可为空
初始保证金，E6 字符串
borrowedE6string可为空
借入本金，E6 字符串
realizedPnlE6string可为空
已实现盈亏，E6 字符串
closeReasonstring可为空
平仓原因
resolutionstring可为空
裁决结果

在响应示例中切换状态码查看错误响应，完整错误码见错误码页。