Order Status Query

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 /futures/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
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
fee	string	Trading fee charged
fee_ccy	string	Trading fee 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
realized_pnl	string	Realized PNL
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": "FUTURES",
        "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",
        "fee": "11.6582326221",
        "fee_ccy": "USDT",
        "maker_fee_rate": "0",
        "taker_fee_rate": "0.0003",
        "last_filled_amount": "27564.87468358",
        "last_filled_price": "1",
        "realized_pnl": "-22.142539215",
        "created_at": 1691482451000,
        "updated_at": 1691482451000,
        "status": "part_deal"
    },
    "message": "OK"
}