Query Order Status
Info
- This endpoint requires signature. For specific signature rules, please refer to Authentication
- This endpoint will trigger rate limit. For specific rules, please refer to Rate Limit.
Dangerous
- After an order without any transactions is canceled, the server will not save the order, nor can the data of this order be queried via any endpoint.
HTTP request
GET /spot/order-status
Request parameters
| Parameter Name | Required | Type | Notes |
|---|---|---|---|
| market | true | string | Market name |
| order_id | true | int | Order ID |
Return parameters
| Parameter Name | Type | Notes |
|---|---|---|
| order_id | int | Order ID |
| market | string | Market name |
| market_type | string | Market Type |
| ccy | string | Currency name |
| side | string | Order side |
| type | string | Order type |
| amount | string | Order amount |
| price | string | Order price |
| unfilled_amount | string | The remaining unfilled amount |
| filled_amount | string | Filled amount |
| filled_value | string | Filled value |
| client_id | string | Client ID |
| base_fee | string | Trading fee charged in base currency |
| quote_fee | string | Trading fee charged in quote currency |
| discount_fee | string | Trading fee charged in deduction currency |
| maker_fee_rate | string | Maker fee rate |
| taker_fee_rate | string | Taker fee rate |
| last_filled_amount | string | Filled amount of the last transaction order_status Null if the order is filled |
| last_filled_price | string | Filled price of the last transaction order_status Null if the order is filled |
| created_at | int | Order creation time |
| updated_at | int | Order update time |
| status | string | Order status |
Request example
GET /spot/order-status?market=CETUSDT&order_id=13400
Response example
{
"code": 0,
"data": {
"order_id": 13400,
"market": " CETUSDT",
"market_type": "MARGIN",
"ccy": "CET",
"side": "buy",
"type": "limit",
"amount": "10000",
"price": "1",
"unfilled_amount": "50241.7185224371",
"filled_amount": "27564.87468358",
"filled_value": "27564.87468358",
"client_id": "client_id_1",
"base_fee": "11.6582326221",
"quote_fee": "0",
"discount_fee": "0",
"maker_fee_rate": "0",
"taker_fee_rate": "0.0003",
"last_fill_amount": "27564.87468358",
"last_fill_price": "1",
"created_at": 1691482451000,
"updated_at": 1691482451000,
"status": "part_deal"
},
"message": "OK"
}