查询订单状态

GET/api/v1/markets/{marketId}/orders/{orderId}Bearer

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

下单 202 响应里的 cursor 就是为这里准备的：?minCursor=…。404 双义（投影未追上 / 订单不存在，逐字节不可区分）——第一个 404 带同一个 cursor 重试，不是最终结果。不是本人的订单同样 404 而非 403（避免枚举订单归属）。

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

路径参数

marketIdstringpath必填
引擎市场 id（读取类端点不接受 slug，除非该端点文档另有说明）
示例"mkt-0001"
orderIdstringpath必填
服务端生成的订单 id（下单 202 响应体返回）
示例"ord_01K5H2M3N7Q8R9S0"

查询参数

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

响应

200订单当前状态

orderIdstring
服务端生成的订单 id
示例"ord_01K5H2M3N7Q8R9S0"
marketIdstring
所属市场
示例"mkt-0001"
outcomeYES | NO
结算方向
示例"YES"
sideBUY | SELL
买卖方向
示例"BUY"
priceE4integer
委托价（1e-4 USD）
示例5200
sizeE2int64
委托量（1e-2 份）
示例1000
filledE2int64
已成交量（1e-2 份）
示例250
statusOPEN | PARTIAL | FILLED | CANCELLED
OPEN=在簿；PARTIAL=部分成交；FILLED=全部成交；CANCELLED=已撤销
示例"OPEN"
reasonstring可为空
终态/拒绝原因（可空）

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

请求

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

响应

订单当前状态

{
  "orderId": "ord_01K5H2M3N7Q8R9S0",
  "marketId": "mkt-0001",
  "outcome": "YES",
  "side": "BUY",
  "priceE4": 5200,
  "sizeE2": 1000,
  "filledE2": 250,
  "status": "OPEN",
  "reason": null
}

路径参数

marketIdstringpath必填
引擎市场 id（读取类端点不接受 slug，除非该端点文档另有说明）
示例"mkt-0001"
orderIdstringpath必填
服务端生成的订单 id（下单 202 响应体返回）
示例"ord_01K5H2M3N7Q8R9S0"

查询参数

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

响应

200订单当前状态

orderIdstring
服务端生成的订单 id
示例"ord_01K5H2M3N7Q8R9S0"
marketIdstring
所属市场
示例"mkt-0001"
outcomeYES | NO
结算方向
示例"YES"
sideBUY | SELL
买卖方向
示例"BUY"
priceE4integer
委托价（1e-4 USD）
示例5200
sizeE2int64
委托量（1e-2 份）
示例1000
filledE2int64
已成交量（1e-2 份）
示例250
statusOPEN | PARTIAL | FILLED | CANCELLED
OPEN=在簿；PARTIAL=部分成交；FILLED=全部成交；CANCELLED=已撤销
示例"OPEN"
reasonstring可为空
终态/拒绝原因（可空）

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