DFS v26.1
Loading
API docs by Redocly

DFS Fee Services API (latest)

Download OpenAPI specification:

Calculates fees/costs for orders in DFS (e.g. Portfolio operations like set up, rebalancing).

For endpoints that support localization the language can be passed either as a query string parameter (using the name 'language') or in the 'accept-language' header.
If no language is passed to such endpoints then the default configured language will be used.

FeeManagement

Retrieve applicable fees for each portfolio change

Retrieves applicable fees for each portfolio change according to pricing

Authorizations:
Bearer
path Parameters
portfolioChangeTypeId
required
integer <int32>

Portfolio Change Type Id

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "results": [
    ]
}

Update applicable fees for each portfolio change

Updates applicable fees for each portfolio change according to pricing

Authorizations:
Bearer
path Parameters
portfolioChangeTypeId
required
integer <int32>

Portfolio Change Type Id

header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

Request DTO

orderTypeId
integer <int32>
Array of objects or null (FeeRequest)

Responses

Request samples

Content type
{
  • "orderTypeId": 0,
  • "fees": [
    ]
}

Response samples

Content type
application/json
{
  • "code": "BadRequest",
  • "subCode": "NA",
  • "message": "The request was not in the required format",
  • "correlationId": "30d3ebc0b5cb47b0889850bbdfe4aec6"
}

Get fee categories

Gets fee categories.

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Responses

Response samples

Content type
application/json
{
  • "feeCategories": [
    ]
}

Calculate estimated trade(s) fees

Calculates estimated trade(s) fees. The fees will be presented at 3 different levels, grouped by instrument, accounts and consolidated in the aggregation currency provided.

Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

Simulate fees request

portfolioId
integer or null <int32>

Id of portfolio

productId
integer or null <int32>

Product used for standard pricing. Only provided when no Portfolio is provided

portfolioChangeTypeId
integer <int32>

Portfolio change type used in the trades (e.g. Rebalancing, Initial Set-up, etc)

aggregationCurrencyId
integer or null <int32>

Currency used as a presentation currency for the fees

Array of objects or null (OrderBookEntry)

Responses

Request samples

Content type
{
  • "portfolioId": 0,
  • "productId": 0,
  • "portfolioChangeTypeId": 0,
  • "aggregationCurrencyId": 0,
  • "orderBookEntries": [
    ]
}

Response samples

Content type
application/json
{
  • "orderBookEntries": [
    ],
  • "aggregatedFees": {
    },
  • "accounts": [
    ]
}

Calculate estimated ex-ante fees

Calculates estimated ex-ante fees for a Portfolio. The possible inputs are:

  • isInCreation: this flag determines whether the portfolio is being created for the first time or already exists (incl. existing positions)
  • portfolioId: The unique identifier of the portfolio for which the fees are to be calculated. Mandatory, if isInCreation=false, otherwise will be ignored
  • currencyId: The unique identifier of the currency for which the fees are to be calculated. Mandatory, if isInCreation=true, otherwise will be ignored
  • productId: The unique identifier of the product for which the fees are to be calculated. Mandatory, if isInCreation=true, otherwise will be ignored
  • investedAmount: The invested amount for which the fees are to be calculated. Mandatory, if isInCreation=true, otherwise will be ignored
  • targetInstrumentAllocations: these are the target instrument allocation of the portfolio
  • language: this is the language in which localizable fields should be returned
  • immediateFees: these are the fields to be returned for the Immediate Fees section of the ex-ante fees calculation
  • recurringFees: these are the fields to be returned for the Recurring Fees section of the ex-ante fees calculation
  • exitFees: these are the fields to be returned for the Exit Fees section of the ex-ante fees calculation
  • projectionFees: these are the fields to be returned for the Projection section of the ex-ante fees calculation
Authorizations:
Bearer
header Parameters
Accept-Language
string

The ISO 639-1 language to use for localizable data.

Request Body schema:

An object containing the necessary details for performing the ex-ante fees calculation.

isInCreation
boolean
portfolioId
integer or null <int32>
currencyId
integer or null <int32>
productId
integer or null <int32>
investedAmount
number or null <double>
Array of objects or null (TargetInstrumentAllocation)
language
string or null
object (CalculateExAnteFeesRequestWithPortfolioChangeType)
object (CalculateExAnteFeesRequestWithPortfolioChangeType)
object (CalculateExAnteFeesRequestWithPortfolioChangeType)
object (CalculateExAnteProjectionFeesRequest)

Responses

Request samples

Content type
{
  • "isInCreation": true,
  • "portfolioId": 0,
  • "currencyId": 0,
  • "productId": 0,
  • "investedAmount": 0.1,
  • "targetInstrumentAllocations": [
    ],
  • "language": "string",
  • "immediateFees": {
    },
  • "recurringFees": {
    },
  • "exitFees": {
    },
  • "projectionFees": {
    }
}

Response samples

Content type
application/json
{
  • "immediateFees": [
    ],
  • "recurringFees": [
    ],
  • "exitFees": [
    ],
  • "projectionFees": [
    ]
}