查询订单(USER-DATA)

类型：USER-DATA

GET /fapi/v1/order

按 ID 查询单个订单。

请求

GET /fapi/v1/order?symbol=BTCUSDT&orderId=<uuid>

Query 参数

参数仅从 URL query string 读取（body 仅参与签名载荷）；query string 缺少必填参数时返回 HTTP 400（axum 的纯文本拒绝，而非 {code, msg} JSON）。

字段	类型	必填	说明
symbol	string	是	standard pair（校验存在性，但不参与过滤——仅按 orderId + 调用用户查找，因此其他 symbol 上的挂单也会返回）。
orderId	UUID string	是	订单 ID。

响应 — 200

{
  "orderId": "8a3f5b2c-4d1e-6f7a-8b9c-0d1e2f3a4b5c",
  "clientOrderId": "8a3f5b2c-4d1e-6f7a-8b9c-0d1e2f3a4b5c",
  "symbol": "BTCUSDT",
  "status": "PARTIALLY_FILLED",
  "side": "BUY",
  "type": "LIMIT",
  "price": "76500.00",
  "origQty": "0.001",
  "updateTime": 1748275200500
}

status 可能为 NEW 或 PARTIALLY_FILLED。完全成交 / 已撤销的订单返回 -2011（已从 ledger.orders_open 移除）。clientOrderId 恒等于 orderId（下单时传的 newClientOrderId 不会存储）；type 恒为 LIMIT；updateTime 为订单创建时间，而非最后成交时间。

错误

HTTP	code	msg
400	-1100	orderId 不是合法 UUID 或 symbol 未知。
422	-2011	订单不存在（或已不再是挂单）。
500	-1000	数据库故障。

签名 / API key 错误（-1021、-1022、-1102、-2014、-2015）及限流（-1003，HTTP 429）适用于所有签名接口；见 错误码。

其他标准字段如 executedQty、cumQuote、avgPrice、stopPrice、reduceOnly、closePosition、time 暂未返回。按 origClientOrderId（而非 orderId）查询 暂未支持。