Skip to content

改單 ​

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

修改已有訂單。

改單結果怎麼看

  • s 為 error 且 need_order_confirm 為 true:還需確認(不是最終失敗),用頂層 confirm_id 調用二次確認。
  • 有 jump_url:請在瀏覽器打開該連結繼續。
  • 這些字段在響應頂層,不在 d 裡。詳見二次確認。

exchange 必填,請直接使用 獲取未完成訂單 或 獲取訂單詳情 返回的值(例如港股常見為 SEHK),不要從標的代碼(如 HK.00700)自行推斷。部分成交後,新數量不能小於已成交數量。需要估算可改數量時,可先調 查詢最大買賣數量 並傳入 order_id。

路徑參數 ​

參數類型必填說明
acc_idstring是業務賬戶 ID。
order_idstring是訂單 ID。

請求參數 ​

參數類型位置必填說明
exchangeexchange請求體是交易所。可選值參見命名詞典 - exchange。
qtystring請求體是修改後的訂單數量。期權和期貨的單位為"合約"。
pricestring請求體否修改後的價格。期貨賬戶精確到 9 位小數,外匯賬戶精確到 5 位小數,證券賬戶精確到 4 位小數,超出部分四捨五入。
aux_pricestring請求體否觸發價格。當訂單類型為 STOP、STOP_LIMIT、MARKET_IF_TOUCHED、LIMIT_IF_TOUCHED 時必填。期貨賬戶精確到 9 位小數,外匯賬戶精確到 5 位小數,證券賬戶精確到 3 位小數,超出部分四捨五入。
trail_typetrail_type請求體否新跟蹤止損類型(僅跟蹤止損單)。
trail_valuestring請求體否新跟蹤金額或百分比(僅跟蹤止損單)。
trail_spreadstring請求體否新指定價差(僅 TRAILING_STOP_LIMIT)。
algo_infoalgo_info請求體否算法單參數。當原訂單為算法單且需修改算法參數時填入,結構同響應 algo_info。

請求示例 ​

bash
curl -X PUT 'https://webapi.moomoo.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

響應參數 ​

欄位類型說明
sstring請求結果。成功為 ok;失敗為 error。
errcodeinteger錯誤碼,僅失敗時返回。
errmsgstring錯誤資訊,僅失敗時返回。
need_order_confirmboolean是否需要二次確認。
confirm_idstring二次確認 ID,用於呼叫「訂單二次確認」介面。
jump_urlstring券商要求開啟網頁時的跳轉 URL。

響應示例 ​

json
{
  "s": "ok"
}

失敗響應:

缺少必填參數 qty:

json
{
  "s": "error",
  "errcode": 485210001,
  "errmsg": "invalid request body"
}

業務錯誤:

json
{
  "s": "error",
  "errcode": 1013,
  "errmsg": "Action failed. This order is partially filled. The new order quantity can't be less than the filled amount. Please adjust the quantity and try again.",
  "need_order_confirm": false
}

需要二次確認:

json
{
  "s": "error",
  "errcode": 108330261,
  "errmsg": "Due to liquidity and market conditions, you may be unable to open or close positions for this security. Do you want to continue?",
  "need_order_confirm": true,
  "confirm_id": "0a1984f400616ae1b2100008eb430000"
}