我的订单列表

GET/api/v1/ordersBearer

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

身份从会话推导。status 支持逗号分隔多值（「仍在簿上」传 status=OPEN,PARTIAL）。不带 marketId 时是跨分区查询，不支持 minCursor（传了 400）；带 marketId 退化为单市场查询，此时支持。

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

查询参数

marketIdstringquery可选
按市场过滤；带上后本端点退化为单市场查询，支持 minCursor
示例"mkt-0001"
statusstringquery可选
逗号分隔的状态过滤
limitintegerquery可选
返回条数上限
默认100范围≥ 1示例20
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/orders?limit=100" \
  -H "Authorization: Bearer $TOKEN"

响应

订单列表

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

查询参数

marketIdstringquery可选
按市场过滤；带上后本端点退化为单市场查询，支持 minCursor
示例"mkt-0001"
statusstringquery可选
逗号分隔的状态过滤
limitintegerquery可选
返回条数上限
默认100范围≥ 1示例20
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可为空
终态/拒绝原因（可空）

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