Skip to navigation

Invest Account Into Model

View as MarkdownOpen in Claude

Submit invest or divest instructions for one or more accounts into a single destination model, with a per-account cash amount. Each entry in accountList pairs an account identifier with the individual amtToInvest value applied to that account (positive to invest, negative to divest).

Constraints and comparison to /fa/model/tws-invest-divest:

  • Only a single model may be targeted per request (the top-level model field). To invest into multiple models in one call, use /fa/model/tws-invest-divest and its modelList.
  • The model must be denominated in a single currency; multi-currency models are not supported by this endpoint. Use /fa/model/tws-invest-divest for models holding instruments across multiple currencies.
  • FA pre-trade allocation groups are not supported here — each account and its individual investment amount must be listed explicitly in accountList.
  • Because each account is listed individually, this endpoint allows a different investment amount per account. /fa/model/tws-invest-divest, by contrast, splits a single amtToInvest equally across accounts when a group or accountList is used.

Authentication

AuthorizationBearer
SSO bearer token.

Request

This endpoint expects an object.
reqIDlongOptional
Request identifier to uniquely track a request.
modelstringOptional
Define the model to invest accounts into.
accountListlist of objectsOptional
Collection of accounts to invest in a model.

Response

Successfully submitted model investment.
reqIDstringOptional
Request identifier to uniquely track a request.
subscriptionStatuslongOptional
Describes if the model is in polling mode.

Errors

401
Unauthorized Error
500
Internal Server Error
503
Service Unavailable Error