二次確認
POST/api/v1.0/accounts/{acc_id}/order_confirm確認訂單。當下單或改單後響應中 need_order_confirm 為 true 時,需要調用此接口進行確認。
如何處理下單和改單結果
部分訂單不能一次完成。接口可能要求您再確認一次,或在瀏覽器打開連結繼續。請根據響應 body 判斷,不要只看 HTTP 狀態碼。need_order_confirm、confirm_id、jump_url 都在響應頂層,不在 d 裡。
| 情況 | s | 關鍵字段 | 含義 | 下一步 |
|---|---|---|---|---|
| 已受理 | ok | 下單時有 d.order_id | 訂單已提交 | 結束;需要時再用訂單查詢核對 |
| 需要確認 | error | need_order_confirm=true,以及 confirm_id、errcode、errmsg | 訂單尚未提交完成;errmsg 為確認說明 | 用本接口提交 confirm_id;確認成功後,下單取 d.order_id,改單確認通常無 d |
| 需要打開網頁 | error | jump_url | 需在瀏覽器完成後續步驟 | 打開 jump_url,不要再調交易接口 |
| 失敗 | error | 沒有以上字段 | 請求被拒絕 | 按 errcode / errmsg 處理 |
confirm_id不是業務訂單號order_id,只用於本接口;請求體只需傳confirm_id。confirm_id有時效;過期或無效時需重新下單或改單。- 若確認後仍返回需要確認或
jump_url,按上表繼續處理。
路徑參數
| 參數 | 類型 | 必填 | 說明 |
|---|---|---|---|
acc_id | string | 是 | 業務賬戶 ID。 |
請求參數
| 參數 | 類型 | 位置 | 必填 | 說明 |
|---|---|---|---|---|
confirm_id | string | 請求體 | 是 | 訂單確認 ID,取自下單或改單響應中的 confirm_id 值。 |
請求示例
bash
curl -X POST 'https://webapi.moomoo.com/api/v1.0/accounts/{acc_id}/order_confirm' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <AccessToken>' \
-d '{
"confirm_id": "0a1984f400616ae1b2100008eb430000"
}' | jq響應參數
| 字段 | 類型 | 說明 |
|---|---|---|
order_id | string | 新訂單 ID,僅在下單確認(非改單確認)時返回。 |
響應示例
下單確認成功:
json
{
"s": "ok",
"d": {
"order_id": "FH1D5A40DCB7B63000"
}
}改單確認成功(無 d / 無新 order_id):
json
{
"s": "ok"
}仍需二次確認(與下單/改單相同形態,字段在頂層):
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"
}