单市场持仓

GET/api/v1/markets/{marketId}/positionBearer

Trading API价 E4 · 量 E2 · 金额 E6（整数）YES | NO

持仓只能查自己的——路径不带 trader 段。chainState 两态：SETTLING = 该 trader 在该市场仍有未确认结算 job; CONFIRMED = 其余。clearing 不可达时整页保守降级 SETTLING（展示层状态，不是资金可用性）。支持单市场 minCursor。

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

路径参数

marketIdstringpath必填
引擎市场 id（读取类端点不接受 slug，除非该端点文档另有说明）
示例"mkt-0001"

查询参数

minCursorstringquery可选
读己之写续读点（下单 202 响应体的 cursor 原样传入）。投影未追上时该查询返回 404，与"资源不存在"不可区分——带同一个 cursor 轮询。
示例"c1:mkt-0001:184"

响应

200持仓

traderstring
服务端回显的会话地址
示例"0x3f1a9c2e7b4…a7b8c9d0e1f"
balanceE6int64
保证金（1e-6 USD）
示例250000000
yesE2int64
YES 份额（1e-2）
示例1000
noE2int64
NO 份额（1e-2）
示例1000
chainStateSETTLING | CONFIRMED
SETTLING=有未确认结算 job;CONFIRMED=全部确认
示例"SETTLING"

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

请求

curl -X GET "$BASE_URL/api/v1/markets/mkt-0001/position" \
  -H "Authorization: Bearer $TOKEN"

响应

持仓

{
  "trader": "0x3f1a9c2e7b4d5e6f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f",
  "balanceE6": 250000000,
  "yesE2": 1000,
  "noE2": 1000,
  "chainState": "SETTLING"
}

路径参数

marketIdstringpath必填
引擎市场 id（读取类端点不接受 slug，除非该端点文档另有说明）
示例"mkt-0001"

查询参数

minCursorstringquery可选
读己之写续读点（下单 202 响应体的 cursor 原样传入）。投影未追上时该查询返回 404，与"资源不存在"不可区分——带同一个 cursor 轮询。
示例"c1:mkt-0001:184"

响应

200持仓

traderstring
服务端回显的会话地址
示例"0x3f1a9c2e7b4…a7b8c9d0e1f"
balanceE6int64
保证金（1e-6 USD）
示例250000000
yesE2int64
YES 份额（1e-2）
示例1000
noE2int64
NO 份额（1e-2）
示例1000
chainStateSETTLING | CONFIRMED
SETTLING=有未确认结算 job;CONFIRMED=全部确认
示例"SETTLING"

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