Get Filled 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.

warning

• 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/finished-order

Request parameters

Parameter Name	Required	Type	Notes
market	false	string	Market name
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
position_side	false	string	Position side. If omitted, orders for all position sides are queried; specify long or short to query orders for a specific position side.
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
side	string	Order side
type	string	Order type
amount	string	Order amount
price	string	Order price
position_side	string	Position side
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
created_at	int	Order creation time
updated_at	int	Order update time

---

Request example

GET /futures/finished-order?market=CETUSDT&market_type=FUTURES&side=buy&page=1&limit=10

Response example

{
    "code": 0,
    "data": [
        {
            "order_id": 13400,
            "market": "CETUSDT",
            "market_type": "FUTURES",
            "side": "buy",
            "type": "limit",
            "amount": "10000",
            "price": "1",
            "position_side": "long",
            "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",
            "created_at": "1691482451000",
            "updated_at": "1691482451000"
        }
    ],
    "pagination": {
        "total": 1,
        "has_next": false
    }
    "message": "OK"
}