查询当前挂单(USER-DATA)
类型:USER-DATA
GET /fapi/v1/openOrders?symbol=...
调用方 key 名下所有未成交订单。可选 symbol 过滤。
标准的单笔挂单查询
GET /fapi/v1/openOrder(单数,按orderId/origClientOrderId)暂未实现;查单笔请用GET /fapi/v1/order,查某交易对全部挂单请用本接口的 symbol 过滤。
请求
GET /fapi/v1/openOrders
Query 参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
symbol | string | 否 | 限定一个 standard pair;省略 = 全部。 |
响应 — 200
[
{
"orderId": "8a3f5b2c-4d1e-6f7a-8b9c-0d1e2f3a4b5c",
"clientOrderId": "8a3f5b2c-4d1e-6f7a-8b9c-0d1e2f3a4b5c",
"symbol": "BTCUSDT",
"status": "NEW",
"side": "BUY",
"type": "LIMIT",
"price": "76500.00",
"origQty": "0.001",
"updateTime": 1748275200500
}
]
返回按 created_at 倒序的前 500 条挂单(无分页)。status 为 NEW 或 PARTIALLY_FILLED;clientOrderId 恒等于 orderId(下单时传的 newClientOrderId 不会存储);type 恒为 LIMIT;updateTime 为订单创建时间。
错误
| HTTP | code | msg |
|---|---|---|
400 | -1100 | 未知 symbol。 |
500 | -1000 | 数据库故障。 |
签名 / API key 错误(-1021、-1022、-1102、-2014、-2015)及限流(-1003,HTTP 429)适用于所有签名接口;见 错误码。