Traditional assets

Ex-ante cost information

post

Ex-ante cost information

Authorizations

Bearer

Header parameters

Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Body

application/json

depositoryCustomerProductIdstring · uuidRequired

cashCustomerProductIdstring · uuidRequired

tradeSidestring · enumRequiredPossible values:

quantityTypestring · enumRequiredPossible values:

exchangeCodestring · enumRequiredPossible values:

orderTypestring · enumRequiredPossible values:

isinstringRequiredPattern: ^[A-Z]{2}[A-Z0-9]{10}$

quantitynumberRequired

pricenumberOptional

This property represents the limit or stop price depending on the order type. It is required for stop/limit orders.

Responses

200

OK

application/json

400

Bad Request

application/json

post

HTTPcURLJavaScriptPython

POST /trading/ex-ante HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Requestor-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 252

{
  "depositoryCustomerProductId": "f4a1d6e8-91cb-4c63-9a82-05d9ea4f5b37",
  "cashCustomerProductId": "a12fc871-d5bc-4fd3-b0d7-d275a1e6c313",
  "tradeSide": "BUY",
  "quantityType": "UNIT",
  "exchangeCode": "TGAT",
  "orderType": "Market",
  "isin": "IE00B4L5Y983",
  "quantity": 10
}

{
  "exAnteId": "ex-ante-20250611-xyz001",
  "createdOn": "2025-06-11T10:23:00Z",
  "asset": {
    "isin": "IE00B4L5Y983",
    "type": "ETF",
    "name": "iShares MSCI World"
  },
  "order": {
    "quantity": 10,
    "tradeSide": "BUY",
    "exchangeCode": "TGAT",
    "grossAmount": 10000,
    "pricePerUnit": 1000,
    "currency": "EUR"
  },
  "costs": [
    {
      "category": "PURCHASE",
      "type": "TRANSACTION",
      "value": 5,
      "percent": 0.05,
      "currency": "EUR"
    },
    {
      "category": "HOLDING",
      "type": "PRODUCT",
      "value": 20,
      "percent": 0.2,
      "currency": "EUR"
    },
    {
      "category": "SALE",
      "type": "TRANSACTION",
      "value": 3,
      "percent": 0.03,
      "currency": "EUR"
    }
  ],
  "total": {
    "productCosts": {
      "ter": 20,
      "percent": 0.2
    },
    "transactionFees": {
      "currency": "eur",
      "feeAmount": 8,
      "percent": 0.08
    },
    "grants": {
      "currency": "EUR",
      "grantsAmount": 0,
      "percent": 0
    }
  },
  "timeline": {
    "year1": {
      "currency": "EUR",
      "feeAmount": 5,
      "percent": 0.25
    },
    "fromYear2": {
      "ter": 100,
      "percent": 1
    },
    "yearOfSale": {
      "currency": "EUR",
      "feeAmount": 3,
      "percent": 0.03
    }
  },
  "metaInfo": {
    "disclaimer": "All values are based on real-time data and are non-binding estimates, assuming a holding period of five years.",
    "explanation": "Transaction fees include execution costs; TER applies only to ETFs."
  }
}

Create Market Order

post

Create a single security market order

Authorizations

Bearer

Header parameters

Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Body

application/json

depositoryCustomerProductIdstring · uuidRequired

The identifier of the depository customer product instance

cashCustomerProductIdstring · uuidRequired

Cash customer product used for the order.

tradeSidestring · enumRequiredPossible values:

quantityTypestring · enumRequiredPossible values:

exchangeCodestring · enumRequiredPossible values:

isinstring · min: 12 · max: 12Required

ISIN of the asset

Example: US38259P5089Pattern: ^[A-Z]{2}[A-Z0-9]{10}$

quantitynumberRequired

Number of shares

externalIdstringRequired

Order id in partner's system. This value has to be unique.

Responses

200

OK

application/json

400

Bad Request

application/json

post

HTTPcURLJavaScriptPython

POST /trading/order/market HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Requestor-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 250

{
  "depositoryCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
  "cashCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
  "tradeSide": "BUY",
  "quantityType": "UNIT",
  "exchangeCode": "TGAT",
  "isin": "US38259P5089",
  "quantity": 1,
  "externalId": "text"
}

No content

Create Limit Order

post

Create a single security limit order

Authorizations

Bearer

Header parameters

Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Body

application/json

depositoryCustomerProductIdstring · uuidRequired

The identifier of the depository customer product instance

cashCustomerProductIdstring · uuidRequired

Cash customer product used for the order.

tradeSidestring · enumRequiredPossible values:

quantityTypestring · enumRequiredPossible values:

exchangeCodestring · enumRequiredPossible values:

isinstring · min: 12 · max: 12Required

ISIN of the asset

Example: US38259P5089Pattern: ^[A-Z]{2}[A-Z0-9]{10}$

quantitynumberRequired

Number of shares

limitPricenumberRequired

The limit price for orders of the type 'limit'.

expiryDatestring · dateRequired

'The order expiration date (last day the order can trade) in the YYYY-MM-DD format. Default value is T+1 year'

externalIdstringRequired

Order id in partner's system. This value has to be unique.

Responses

200

OK

application/json

400

Bad Request

application/json

post

HTTPcURLJavaScriptPython

POST /trading/order/limit HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Requestor-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 291

{
  "depositoryCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
  "cashCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
  "tradeSide": "BUY",
  "quantityType": "UNIT",
  "exchangeCode": "TGAT",
  "isin": "US38259P5089",
  "quantity": 1,
  "limitPrice": 1,
  "expiryDate": "2025-09-18",
  "externalId": "text"
}

No content

Create Stop Order

post

Create a single security stop order

Authorizations

Bearer

Header parameters

Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Body

application/json

depositoryCustomerProductIdstring · uuidRequired

The identifier of the depository customer product instance

cashCustomerProductIdstring · uuidRequired

Cash customer product used for the order.

tradeSidestring · enumRequiredPossible values:

quantityTypestring · enumRequiredPossible values:

exchangeCodestring · enumRequiredPossible values:

isinstring · min: 12 · max: 12Required

ISIN of the asset

Example: US38259P5089Pattern: ^[A-Z]{2}[A-Z0-9]{10}$

quantitynumberRequired

Number of shares

stopPricenumberRequired

The stop price for orders of the type 'stop'.

expiryDatestring · dateRequired

'The order expiration date (last day the order can trade) in the YYYY-MM-DD format. Default value is T+1 year'

externalIdstringRequired

Order id in partner's system. This value has to be unique.

Responses

200

OK

application/json

400

Bad Request

application/json

post

HTTPcURLJavaScriptPython

POST /trading/order/stop HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Requestor-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 290

{
  "depositoryCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
  "cashCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
  "tradeSide": "BUY",
  "quantityType": "UNIT",
  "exchangeCode": "TGAT",
  "isin": "US38259P5089",
  "quantity": 1,
  "stopPrice": 1,
  "expiryDate": "2025-09-18",
  "externalId": "text"
}

No content

Cancel order

delete

Cancel a single trading order. Please note that Market orders have a low probability of being canceled.

Authorizations

Bearer

Path parameters

orderIdstring · uuidRequired

Header parameters

Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Responses

202

Accepted

400

Bad Request

application/json

404

Not Found

application/json

delete

HTTPcURLJavaScriptPython

DELETE /trading/order/{orderId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Requestor-ID: 123e4567-e89b-12d3-a456-426614174000
Accept: */*

No content

Get Orders

get

Get orders

Authorizations

Bearer

Path parameters

depositoryCustomerProductIdstring · uuidRequired

Query parameters

statusstring · enumOptional

Order status. If not send all statues will be returned.

Possible values:

startCreatedOnstring · date-timeOptional

Display orders created on or after this date

endCreatedOnstring · date-timeOptional

Display orders created on or before this date

limitinteger · min: 1Optional

Maximum number of items to return

Default: 20

cursorstringOptional

String value used for pagination

externalIdstring · uuidOptional

Responses

200

OK

application/json

400

Bad Request

application/json

get

HTTPcURLJavaScriptPython

GET /trading/{depositoryCustomerProductId}/orders HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "data": [
    {
      "orderId": "123e4567-e89b-12d3-a456-426614174000",
      "exAnteId": "123e4567-e89b-12d3-a456-426614174000",
      "createdOn": "2025-09-18T03:36:59.352Z",
      "modifiedOn": "2025-09-18T03:36:59.352Z",
      "status": "RECEIVED",
      "message": "text",
      "execution": {
        "executionPrice": 1,
        "executionQuantity": 1,
        "remainingQuantity": 1,
        "valueDate": "2025-09-18",
        "bookingDate": "2025-09-18",
        "transactionTime": "2025-09-18T03:36:59.352Z",
        "amount": -1523.25,
        "feeAmount": -1523.25,
        "feeDescription": "text",
        "amountCurrency": "EUR",
        "partialExecutions": [
          {
            "executionPrice": 1,
            "executionQuantity": 1,
            "amount": -1523.25,
            "executionTime": "2025-09-18T03:36:59.352Z",
            "valueDate": "2025-09-18",
            "bookingDate": "2025-09-18",
            "tradeInvoiceId": "123e4567-e89b-12d3-a456-426614174000"
          }
        ]
      },
      "depositoryCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
      "cashCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
      "tradeSide": "BUY",
      "isin": "US38259P5089",
      "quantity": 1,
      "orderType": "LIMIT",
      "quantityType": "UNIT",
      "limitPrice": 1,
      "stopPrice": 1,
      "expiryDate": "2025-09-18",
      "externalId": "text",
      "asset_experience_fit": true,
      "exchangeCode": "TGAT"
    }
  ],
  "pagination": {
    "cursor": "text",
    "limit": 1
  }
}

Get Order

get

Get single order

Authorizations

Bearer

Path parameters

orderIdstring · uuidRequired

Responses

200

OK

application/json

400

Bad Request

application/json

404

Not Found

application/json

get

HTTPcURLJavaScriptPython

GET /trading/order/{orderId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "orderId": "123e4567-e89b-12d3-a456-426614174000",
  "exAnteId": "123e4567-e89b-12d3-a456-426614174000",
  "createdOn": "2025-09-18T03:36:59.352Z",
  "modifiedOn": "2025-09-18T03:36:59.352Z",
  "status": "RECEIVED",
  "message": "text",
  "execution": {
    "executionPrice": 1,
    "executionQuantity": 1,
    "remainingQuantity": 1,
    "valueDate": "2025-09-18",
    "bookingDate": "2025-09-18",
    "transactionTime": "2025-09-18T03:36:59.352Z",
    "amount": -1523.25,
    "feeAmount": -1523.25,
    "feeDescription": "text",
    "amountCurrency": "EUR",
    "partialExecutions": [
      {
        "executionPrice": 1,
        "executionQuantity": 1,
        "amount": -1523.25,
        "executionTime": "2025-09-18T03:36:59.352Z",
        "valueDate": "2025-09-18",
        "bookingDate": "2025-09-18",
        "tradeInvoiceId": "123e4567-e89b-12d3-a456-426614174000"
      }
    ]
  },
  "depositoryCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
  "cashCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
  "tradeSide": "BUY",
  "isin": "US38259P5089",
  "quantity": 1,
  "orderType": "LIMIT",
  "quantityType": "UNIT",
  "limitPrice": 1,
  "stopPrice": 1,
  "expiryDate": "2025-09-18",
  "externalId": "text",
  "asset_experience_fit": true,
  "exchangeCode": "TGAT"
}

Get trade invoice

get

Get order trade invoice

Authorizations

Bearer

Path parameters

tradeInvoiceIdstring · uuidRequired

Id of the trade invoice

Responses

200

OK

application/pdf

Responsestring · binary

400

Bad Request

application/json

404

Not Found

application/json

get

HTTPcURLJavaScriptPython

GET /trading/order/trade-invoice/{tradeInvoiceId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content

Get ExAnte Receipt

get

Get order receipt

Authorizations

Bearer

Path parameters

exAnteIdstring · uuidRequired

Id of the ex ante costs

Responses

200

OK

application/pdf

Responsestring · binary

400

Bad Request

application/json

404

Not Found

application/json

get

HTTPcURLJavaScriptPython

GET /trading/ex-ante/{exAnteId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

No content