Get Unfilled Order

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/pending-order

Request parameters

Parameter Name	Required	Type	Notes
market	false	string	Market name. Pass to return orders in all markets Note: market_type MARGIN cannot be null or passed
market_type	true	string	Market type. Note: In spot related functions, only SPOT or MARGIN can be used. In futures related functions, only FUTURES can be used.
side	false	string	Order side, null to return orders of both sides
client_id	false	string	User-defined ID
page	false	int	Number of pagination. Default is 1.
limit	false	int	Number in each page. Default is 10.

---

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
last_filled_price	string	Filled price of the last transaction
created_at	int	Order creation time
updated_at	int	Order update time

---

Request example

GET /spot/pending-order?market=CETUSDT&market_type=MARGIN&order_side=buy&page=1&limit=10

Response example

{
    "code": 0,
    "data": [
        {
            "order_id": 13400,
            "market": " CETUSDT",
            "market_type": "MARGIN",
            "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
        }
    ],
    "pagination": {
        "total": 1,
        "has_next": false
    }
    "message": "OK"
}