改單

PUT /api/v1.0/accounts/{acc_id}/orders/{order_id}

修改已有訂單。

注意

不支持修改 A 股訂單。

路徑參數

參數	類型	必填	說明
acc_id	string	是	業務賬戶 ID。
order_id	string	是	訂單 ID。

請求參數

參數	類型	位置	必填	說明
exchange	Exchange	請求體	是	交易所。可選值參見命名詞典 - exchange。
qty	string	請求體	是	修改後的訂單數量。期權和期貨的單位為"合約"。
price	string	請求體	是	修改後的價格。期貨精確到 9 位小數，其他標的精確到 4 位小數，超出部分將被截斷。
aux_price	string	請求體	否	觸發價格。當訂單類型為 STOP、STOP_LIMIT、MARKET_IF_TOUCHED、LIMIT_IF_TOUCHED 時必填。證券賬戶精確到 3 位小數，期貨精確到 9 位小數。

請求示例

curl -X PUT 'https://webapi.futunn.com/api/v1.0/accounts/{acc_id}/orders/{order_id}' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer <AccessToken>' \
  -d '{
    "exchange": "US",
    "qty": "200",
    "price": "155.00"
  }' | jq

響應示例

{
  "s": "ok"
}

失敗響應：

普通錯誤：

{
  "s": "error",
  "errcode": -1200,
  "errmsg": "Error message."
}

特殊場景 - 需要二次確認：

{
  "s": "error",
  "errcode": -2100,
  "errmsg": "Order confirmation required.",
  "need_order_confirm": true,
  "confirm_id": "a confirm id"
}

特殊場景 - 需要打開網頁：

{
  "s": "error",
  "errcode": -2101,
  "errmsg": "Action required in browser.",
  "need_order_confirm": false,
  "jump_url": "a jump url"
}

提示

• 當響應中 need_order_confirm 為 true 時，需調用二次確認接口完成訂單確認。
• 當響應中包含 jump_url 時，請在瀏覽器中打開該鏈接完成後續操作。