Order Confirm
POST/api/v1.0/accounts/{acc_id}/order_confirmConfirm an order. Call this endpoint when place or modify returns need_order_confirm as true.
How to handle place and modify results
Some orders cannot finish in one step. The API may ask you to confirm again, or to continue in a browser. Decide from the response body, not only the HTTP status. need_order_confirm, confirm_id, and jump_url are top-level fields, not inside d.
| Case | s | Key fields | Meaning | Next step |
|---|---|---|---|---|
| Accepted | ok | d.order_id on place | Order submitted | Done; query orders later if needed |
| Needs confirm | error | need_order_confirm=true, plus confirm_id, errcode, errmsg | Order is not fully submitted yet; errmsg explains the confirm | Call this API with confirm_id; after success, read d.order_id on place; modify confirm usually has no d |
| Needs browser | error | jump_url | Continue in a browser | Open jump_url; do not call another trading API |
| Failed | error | None of the above | Request rejected | Handle via errcode / errmsg |
confirm_idis not the businessorder_id. Use it only with this endpoint; request body only needsconfirm_id.confirm_idexpires; if it expires or is invalid, place or modify again.- If confirm still returns needs-confirm or
jump_url, continue with the table above.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
acc_id | string | Yes | Business account ID. |
Request Parameters
| Parameter | Type | Position | Required | Description |
|---|---|---|---|---|
confirm_id | string | body | Yes | Order confirm ID from the place or modify response. |
Request Example
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"
}' | jqResponse Parameters
| Field | Type | Description |
|---|---|---|
order_id | string | New order ID, returned only when confirming a new order (not a modification). |
Response Example
Place confirm success:
json
{
"s": "ok",
"d": {
"order_id": "FH1D5A40DCB7B63000"
}
}Modify confirm success (no d / no new order_id):
json
{
"s": "ok"
}Still needs confirm (same shape as place/modify; fields at top level):
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"
}