Submitting your fee structure & order details

One of the prerequisites for the preparation of a consistent ex-ante cost report is that you as the client provide us with your planned fee structure and order details in advance. Only in this way is it possible for us to compile correct ex-ante cost reports for your end users.

With this approach, Upvest offers its clients maximum flexibility to incorporate individual and very specific pricing models (e.g. the distinction between basic and premium users). In practical terms, this means that the client can change the fee models on their side without further notice (e.g. increase order fees from EUR 1.00 to EUR 2.00 per transaction).

Create a user report

Please make the following API call to submit your fee structure and order details via the Investment API.

POST /reports

Example request

Details

{
  "type": "ORDER_EX_ANTE_COST",
  "order": {
    "user_id": "d1a4be99-8bb6-4e78-b897-8168f6823ab5",
    "account_id": "c5034305-c441-4711-adbf-93cfbc13a695",
    "order_type": "MARKET",
    "side": "SELL",
    "instrument_id": "LU0274208692",
    "instrument_id_type": "ISIN",
    "currency": "EUR",
    "cash_amount": "1000.00"
  },
  "fees": [
    {
      "type": "TRANSACTION_FEE_BUY",
      "value_type": "ABSOLUTE",
      "cash_amount": "1.00",
      "currency": "EUR"
    },
    {
      "type": "TRANSACTION_FEE_SELL",
      "value_type": "ABSOLUTE",
      "cash_amount": "0.90",
      "currency": "EUR"
    },
    {
      "type": "ANNUAL_AUM_BASED_FEE",
      "value_type": "RELATIVE",
      "bps": "10"
    }
  ]
}

As the request body contains an order object, it can be used both for the creation of ex-ante cost reports and for the creation of actual orders.

In addition, the request body also contains the fees object, and thus also all cost information used to create the ex-ante cost report.