API status

Calculation & intake on Upvest side

Both service and transaction fees can be implemented via Upvest.

Upvest calculates the fee as a percentage of assets under management (AUM) and charges it to end users based on the frequency of fee collections previously agreed with the client and upon account liquidation.

Prerequisites

The following requirements apply:

  • To be able to use the fee collection function, Upvest must activate the relevant API endpoints for you.

  • To collect fees from a cash balance or via cover orders, the user must have an active account group and account.

    You can find out more about creating accounts and account groups here.

Implementation steps

In order to implement this setup you will need to perform the following steps:

  1. Define the fee structure

    Define the desired fee structure, scope and frequency of the fee intake.
    Example:

    30 bps (basis points, 1 bps=0,01%), of which 20bps are a service fee and 10 bps are a transaction lump sum fee, taken once a year


  2. Define the fee collection method

    To collect the fees, Upvest will issue a sell order by default to cover the fees. For more details, see 'Sell-to-cover order' below.
    Further fee collection options can be implemented after consultation with Upvest.


  3. Communication with Upvest

    Inform Upvest of the desired fee models and the collection method. You will receive the respective fee model IDs with which you can assign the respective fee models to the individual accounts.
    Learn more about fee models here.


  4. Setup the fee configurations

    Set up fee configurations for all accounts that need to be debited.
    Learn more about fee configuration here.


    Upvest provides the ability to update assigned fee configurations via the API, giving you the flexibility to change the user's fee model based on the logic in your system.


Fee collection

Fees will then be charged on the day of the planned fee collection or when the account is closed.

Please note that you can only start a fee collection for accounts that are not in PENDING_APPROVAL or CLOSED status. If the account is in one of these statuses, a Bad Request response code will be returned.
Otherwise, you will receive a fee collection object with the fee collection ID in the response.

If the selected collection strategy is ‘Sell-to-cover’, Upvest triggers the corresponding orders to collect the money. You can recognise orders that are created to cover fees by the initiation_flow value in the order event: SELL_TO_COVER_FEES.

Further details can be found in the section 'Implementation of sell-to-cover orders below.

The fee collection is finalised after the sales order has been processed. You receive an event FEE_COLLECTION.FINALISED. All cash remaining from the sales orders that is not used for fees is available for withdrawal.