Open Orders
Query user's current unfilled orders (status is new or partially filled).
API Information
- Method:
GET - Path:
/api/v1/openOrders - Authentication: Requires signature authentication (see Common Module · Signature Specification)
Request Parameters
| Parameter | Location | Type | Required | Description |
|---|---|---|---|---|
| symbol | query | string | No | Trading pair, e.g. BTC_USDT |
| limit | query | integer | No | Return quantity, default 500, max 1000 |
Request Example
GET /api/v1/openOrders?symbol=BTC_USDT&limit=100
Response Fields
Returns order array, fields refer to "Order Detail" interface.
| Field | Type | Description |
|---|---|---|
| code | integer | Status code |
| message | string | Response message |
| data | array | Order list |
| data[].id | string | Order ID |
| data[].client_order_id | string | Client order ID |
| data[].symbol | string | Trading pair |
| data[].side | integer | Side |
| data[].type | integer | Type |
| data[].status | integer | Status |
| data[].price | string | Order price |
| data[].qty | string | Order quantity |
| data[].filled_qty | string | Filled quantity |
| data[].filled_quote | string | Filled amount |
| data[].avg_price | string | Average filled price |
| data[].created_at | integer | Creation time (milliseconds) |
| data[].updated_at | integer | Update time (milliseconds) |
Response Example
{
"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"
}
]
}