Modify 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

• Modifying an order will directly modify the original order, and the returned order_id will be the same as before.

HTTP request

POST /futures/modify-order

Request parameters

Parameter Name	Required	Type	Notes
market	true	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.
order_id	true	int	Order ID
amount	false	string	Order amount, which should include at least one of the two parameters, amount/price. The amount value must be greater than the original order's executed amount.
price	false	string	Order price, which should include at least one of the two parameters, amount/price

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

---

Request example

{
    "market": "CETUSDT",
    "market_type": "FUTURES",
    "order_id": 13400,
    "amount": "10000",
    "price": "1"
}

Response example

{
    "code": 0,
    "data": {
        "order_id": 13401,
        "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
    },
    "message": "OK"
}