改單

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