Skip to navigation
API ReferenceTradingTrading Fa Model Portfolios

Submit New Model Portfolio Order

View as MarkdownOpen in Claude

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