当前委托
查询用户当前未完成的订单(状态为新建或部分成交)。
接口信息
- 方法:
GET - 路径:
/api/v1/openOrders - 鉴权: 需要签名认证(详见 公共模块 · 签名说明)
请求参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| symbol | query | string | 否 | 交易对,如 BTC_USDT |
| limit | query | integer | 否 | 返回数量,默认 500,最大 1000 |
请求示例
GET /api/v1/openOrders?symbol=BTC_USDT&limit=100
响应字段
返回订单数组,字段参考"订单详情"接口。
| 字段 | 类型 | 说明 |
|---|---|---|
| code | integer | 状态码 |
| message | string | 返回消息 |
| data | array | 订单列表 |
| data[].id | string | 订单 ID |
| data[].client_order_id | string | 客户端订单 ID |
| data[].symbol | string | 交易对 |
| data[].side | integer | 方向 |
| data[].type | integer | 类型 |
| data[].status | integer | 状态 |
| data[].price | string | 委托价格 |
| data[].qty | string | 委托数量 |
| data[].filled_qty | string | 已成交数量 |
| data[].filled_quote | string | 已成交金额 |
| data[].avg_price | string | 成交均价 |
| data[].created_at | integer | 创建时间(毫秒) |
| data[].updated_at | integer | 更新时间(毫秒) |
响应示例
{
"code": 0,
"message": "success",
"data": [
{
"id": "1234567890123456789",
"client_order_id": "my-order-001",
"symbol": "BTC/USDT",
"side": 1,
"type": 1,
"status": 2,
"price": "30000",
"qty": "0.1",
"quote_qty": "0",
"filled_qty": "0.05",
"filled_quote": "1500",
"avg_price": "30000",
"total_fee": "0.0001",
"fee_asset": "BTC",
"cancel_reason": "USER",
"created_at": 1704067200000,
"updated_at": 1704067200000,
"user_id": "user123"
}
]
}