改单

PUT /api/v1/crypto/accounts/{acc_id}/orders/{orderId}

修改已提交的未成交订单的价格或数量。

使用限制

• 仅支持修改未触发（ord_status = PENDING_TRIGGER）的条件订单；触发后不可改单。
• qty 和 price 均为必填。若只需修改其中一项，另一项传入订单当前值即可。

路径参数

参数	类型	必填	说明
acc_id	uint64	是	账户 ID
orderId	string	是	要修改的订单 ID

请求参数

参数	类型	位置	必填	说明
req_id	string	请求体	是	幂等 ID，长度 16–64 字符，网关加 gw_ 前缀后透传至下游用于防重
qty	string	请求体	是	修改后的委托数量
price	string	请求体	是	修改后的委托价格
order_version	uint32	请求体	是	订单版本号，用于乐观锁校验，取自订单详情的 version 字段
conditional_info	object	请求体	否	条件单信息，仅条件单改单时填写

conditional_info 字段

参数	类型	必填	说明
trigger_price	string	是	条件单触发价

请求示例

curl -X PUT "https://webapi.futunn.com/api/v1/crypto/accounts/123456/orders/FTHC2989880641155745280T" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: <AppKey>" \
  -H "X-Timestamp: <timestamp_ms>" \
  -H "X-Nonce: <nonce>" \
  -H "Authorization: <signature_base64>" \
  -d '{
    "req_id": "1750000000001_a1b2c3d4e5f6g7h8",
    "qty": "0.02",
    "price": "29500",
    "order_version": 1
  }'

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "order_id": "FTHC2989880641155745280T"
  }
}

失败响应：

{
  "code": 1,
  "msg": "Error message."
}