改單
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_id | string | 是 | 業務賬戶 ID。 |
order_id | string | 是 | 訂單 ID。 |
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
exchange | exchange | 請求體 | 是 | 交易所。可選值參見命名詞典 - exchange。 |
qty | string | 請求體 | 是 | 修改後的訂單數量。期權和期貨的單位為"合約"。 |
price | string | 請求體 | 否 | 修改後的價格。期貨賬戶精確到 9 位小數,外匯賬戶精確到 5 位小數,證券賬戶精確到 4 位小數,超出部分四捨五入。 |
aux_price | string | 請求體 | 否 | 觸發價格。當訂單類型為 STOP、STOP_LIMIT、MARKET_IF_TOUCHED、LIMIT_IF_TOUCHED 時必填。期貨賬戶精確到 9 位小數,外匯賬戶精確到 5 位小數,證券賬戶精確到 3 位小數,超出部分四捨五入。 |
trail_type | trail_type | 請求體 | 否 | 新跟蹤止損類型(僅跟蹤止損單)。 |
trail_value | string | 請求體 | 否 | 新跟蹤金額或百分比(僅跟蹤止損單)。 |
trail_spread | string | 請求體 | 否 | 新指定價差(僅 TRAILING_STOP_LIMIT)。 |
algo_info | algo_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響應參數
| 欄位 | 類型 | 說明 |
|---|---|---|
s | string | 請求結果。成功為 ok;失敗為 error。 |
errcode | integer | 錯誤碼,僅失敗時返回。 |
errmsg | string | 錯誤資訊,僅失敗時返回。 |
need_order_confirm | boolean | 是否需要二次確認。 |
confirm_id | string | 二次確認 ID,用於呼叫「訂單二次確認」介面。 |
jump_url | string | 券商要求開啟網頁時的跳轉 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"
}