Modify Order

Modify the price or quantity of an unfilled perpetual futures order (cancel old order + place new order).

API Information

• Method: PUT
• Path: /fapi/v1/orders/{id}
• Authentication: Requires signature authentication (see Common Module · Signature Specification)

Request Parameters

Parameter	Location	Type	Required	Description
id	path	string	Yes	Original order ID

Body

Parameter	Type	Required	Description
price	string	Yes	New price
qty	string	Yes	New quantity
resp_type	integer	No	Response type: 1=ACK, 2=RESULT, 3=FULL (default 2)

Request Example

PUT /fapi/v1/orders/1234567890123456789

{
  "price": "68600.00",
  "qty": "0.2",
  "resp_type": 2
}

Response Fields

Returns the modified order information (same as order detail).

Field	Type	Description
code	integer	Status code
message	string	Response message
data.id	string	New order ID
data.client_order_id	string	Client order ID
data.symbol	string	Trading pair
data.status	integer	Order status
data.price	string	Order price
data.qty	string	Order quantity
data.updated_at	integer	Update time (milliseconds)

Response Example

{
  "code": 0,
  "message": "success",
  "data": {
    "id": "1234567890123456790",
    "symbol": "BTC_USDT",
    "client_order_id": "my-order-001",
    "status": 1,
    "price": "68600.00",
    "qty": "0.2",
    "filled_qty": "0",
    "filled_quote": "0",
    "avg_price": "0",
    "side": 1,
    "type": 1,
    "leverage": 10,
    "margin_mode": 1,
    "position_action": 1,
    "position_side": 1,
    "created_at": 1711929800000,
    "updated_at": 1711929800000,
    "user_id": "user123"
  }
}