Submit New Model Portfolio Order

POST

/v1/api/iserver/account/:modelCode/orders

Create Model Portfolio invest or rebalancing order. Submits one or more order instructions against the Model Portfolio identified by modelCode in the URL path. Each order entry follows the standard IBKR order submission contract used by /iserver/account/{accountId}/orders, with acctId set to the target sub-account and orders routed under the model.

This endpoint returns either a list of successfully submitted order confirmations or a list of reply objects that require follow-up confirmation via /iserver/reply/{replyId} before the orders are transmitted.

Create Model Portfolio invest or rebalancing order. Submits one or more order instructions against the Model Portfolio identified by `modelCode` in the URL path. Each order entry follows the standard IBKR order submission contract used by `/iserver/account/{accountId}/orders`, with `acctId` set to the target sub-account and orders routed under the model. This endpoint returns either a list of successfully submitted order confirmations or a list of reply objects that require follow-up confirmation via `/iserver/reply/{replyId}` before the orders are transmitted.

Authentication

AuthorizationBearer

SSO bearer token.

Path parameters

modelCodestringRequired

Name of the target Model Portfolio to receive the invest or rebalancing order.

Request

This endpoint expects an object.

orderslist of objectsRequired

Collection of order instructions to submit against the model portfolio.

Response

Successfully submitted the model portfolio order(s). The response is either a list of order confirmations, or a list of reply objects requiring follow-up confirmation via /iserver/reply/{replyId}.

order_idstringOptional

Identifier of the submitted model portfolio order.

order_statusstringOptional

Current status of the submitted order (e.g. PreSubmitted, Submitted, Filled).

encrypt_messagestringOptional

Internal encrypted acknowledgement of the submission.

idstringOptional

Reply identifier returned when the order requires additional confirmation. Supply this value to /iserver/reply/{replyId} to continue submission.

messagelist of stringsOptional

Confirmation prompts that must be acknowledged before the order is transmitted.

isSuspendedbooleanOptional

True if the order is suspended pending reply confirmation.

Errors

400

Bad Request Error

401

Unauthorized Error

500

Internal Server Error

503

Service Unavailable Error