Overview
Accounts and account groups are central resources in the Investment API. They are linked to the user in a specific hierarchy and are required to carry out processes such as placing orders. Both resources have positions: While account groups hold cash, accounts hold units.
This overview introduces the concepts of accounts, account groups and account types within the Upvest Investment API.
Account groups
An account group aggregates all accounts within it for tax calculation and regulatory reporting purposes. We assign official security account numbers at the account group level. Account groups hold positions in the form of cash.
Upvest supports a multi-portfolio setup by allowing clients to open more than one account group.
This feature will be activated for you on request, please contact us if you are interested.
Accounts
An account cannot exist within the Investment API without being associated with an account group. Accounts hold positions in the form of units.
Account types
We currently support one type on the account group level, and two types on the account level:
| Account level | Account type | Description |
|---|---|---|
| Account group | PERSONAL | Account group of an individual person holding securities on their own behalf. |
| Account | TRADING | Account allows orders to be placed at instrument level and positions to be queried in the account. |
| Account | PORTFOLIO | Account allows orders to be placed at a portfolio level and positions to be queried in the account. |
Coming soon
More types of account groups such as joint account groups or child account groups will follow soon.