未完成的链上结算（逐笔）

GET/api/v1/me/settlementsBearer

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

本人名下全部未完成的链上结算，最新在前。settlementStatus 产品口径：SETTLING ← QUEUED/SUBMITTED;RETRYING ← FAILED_RETRYABLE;FAILED ← FAILED_TERMINAL（账本与链上已分叉，处置前别基于它报价）。不在列表里 = 已结算。clearing 不可用时返回 503，不降级成空列表——空列表等于 "全部已结算"，对风险查询是方向性错误。

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

响应

200未完成结算列表

响应为数组，以下为每个元素的字段：

jobIdstring
partition-offset-fillIndex，稳定可幂等去重
示例"job_01K5H2M3N7"
marketIdstring
市场 id
示例"mkt-0001"
roleMAKER | TAKER
本人在这笔成交中的角色
示例"MAKER"
settlementStatusSETTLING | RETRYING | FAILED
SETTLING=结算中；RETRYING=失败重试中；FAILED=终局失败，待人工介入
示例"SETTLING"
takerIsYesboolean
taker 腿方向（true = taker 买 YES）
示例false
yesPriceE4integer
成交 YES 价（1e-4）;payloadCorrupted=true 时为 0
示例5200
sizeE2int64
成交量（1e-2 份）;payloadCorrupted=true 时为 0
示例1000
attemptsinteger
链上提交尝试次数
示例1
lastErrorstring可为空
最近一次失败原因（运维排查用）
chainTxDigeststring可为空
已广播交易的链上摘要
示例"9wq1XbH7c2M4p…nP4sU7wXk3Z"
payloadCorruptedboolean
true = job 载荷损坏，价量明细已降级为 0
示例false
createdAtstring
job 创建时刻
示例"2026-09-19T00:00:00Z"
updatedAtstring
最近状态变更时刻
示例"2026-09-19T00:00:00Z"

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

请求

curl -X GET "$BASE_URL/api/v1/me/settlements" \
  -H "Authorization: Bearer $TOKEN"

响应

未完成结算列表

[
  {
    "jobId": "job_01K5H2M3N7",
    "marketId": "mkt-0001",
    "role": "MAKER",
    "settlementStatus": "SETTLING",
    "takerIsYes": false,
    "yesPriceE4": 5200,
    "sizeE2": 1000,
    "attempts": 1,
    "lastError": null,
    "chainTxDigest": "9wq1XbH7c2M4pQ8rT1vY5zA3dF6gJ9kL2nP4sU7wXk3Z",
    "payloadCorrupted": false,
    "createdAt": "2026-09-19T00:00:00Z",
    "updatedAt": "2026-09-19T00:00:00Z"
  }
]

响应

200未完成结算列表

响应为数组，以下为每个元素的字段：

jobIdstring
partition-offset-fillIndex，稳定可幂等去重
示例"job_01K5H2M3N7"
marketIdstring
市场 id
示例"mkt-0001"
roleMAKER | TAKER
本人在这笔成交中的角色
示例"MAKER"
settlementStatusSETTLING | RETRYING | FAILED
SETTLING=结算中；RETRYING=失败重试中；FAILED=终局失败，待人工介入
示例"SETTLING"
takerIsYesboolean
taker 腿方向（true = taker 买 YES）
示例false
yesPriceE4integer
成交 YES 价（1e-4）;payloadCorrupted=true 时为 0
示例5200
sizeE2int64
成交量（1e-2 份）;payloadCorrupted=true 时为 0
示例1000
attemptsinteger
链上提交尝试次数
示例1
lastErrorstring可为空
最近一次失败原因（运维排查用）
chainTxDigeststring可为空
已广播交易的链上摘要
示例"9wq1XbH7c2M4p…nP4sU7wXk3Z"
payloadCorruptedboolean
true = job 载荷损坏，价量明细已降级为 0
示例false
createdAtstring
job 创建时刻
示例"2026-09-19T00:00:00Z"
updatedAtstring
最近状态变更时刻
示例"2026-09-19T00:00:00Z"

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