修改订单

修改未成交的永续合约订单价格或数量（旧订单撤单 + 新订单下单）。

接口信息

• 方法: PUT
• 路径: /fapi/v1/orders/{id}
• 鉴权: 需要签名认证（详见 公共模块 · 签名说明）

请求参数

参数	位置	类型	必填	说明
id	path	string	是	原订单 ID

Body

参数	类型	必填	说明
price	string	是	新价格
qty	string	是	新数量
resp_type	integer	否	响应类型：1=ACK，2=RESULT，3=FULL（默认 2）

请求示例

PUT /fapi/v1/orders/1234567890123456789

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

响应字段

返回修改后的订单信息（同订单详情）。

字段	类型	说明
code	integer	状态码
message	string	返回消息
data.id	string	新订单 ID
data.client_order_id	string	客户端订单 ID
data.symbol	string	交易对
data.status	integer	订单状态
data.price	string	委托价格
data.qty	string	委托数量
data.updated_at	integer	更新时间（毫秒）

响应示例

{
  "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"
  }
}