Orders

Create Market Order

post

/wawex/orders/market

Create a new market order.

eWP / Tradevest DeFi Yield Kryptowertpapier (TVDY) orders ride this same partner endpoint (there is no separate /digital partner pipeline); the platform detects the eWP symbol and routes internally. eWP-specific rules:

BUY is amount-based: send quantityType: AMOUNT and put the EUR amount to invest in quantity (min 1.000 €, max 8.000.000 € per order). SELL is unit-based: send quantityType: UNIT and put the number of units to redeem in quantity (no min/max).
A mandatory ex-ante cost disclosure (MiFID) is generated server-side on every order and linked to it — the partner never passes an exAnteId. Retrieve it later via GET /wawex/orders/{orderId} (exAnteId) and download the PDF at GET /wawex/ex-ante/{exAnteId}/receipt.
BUY orders must pass an eligibility gate: declared free available assets ≥ 100.000 € or the order amount ≤ 2× the customer's average monthly net income. A failing gate rejects the order (INVALID/REJECTED with a reason). SELL/redemptions are exempt.
The order accumulates into the currently-open subscription (BUY) or redemption (SELL) batch and is settled at a uniform clearing price when Ops closes the batch; there are no partial fills. Status moves RECEIVED → PENDING → FILLED. Cancel a still-pending order with DELETE /wawex/orders/{orderId} until its batch is closed.

Authorizations

HTTPRequired

Header parameters

Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Body

symbolstringRequired

Trading symbol (e.g. TVDY for eWP).

Example: TVDY

quantitynumber · decimalRequired

Order quantity, interpreted per quantityType. With AMOUNT it is a EUR cash amount (eWP BUY: min 1.000 €, max 8.000.000 €); with UNIT it is a number of units (eWP SELL: no min/max).

Example: 5000

quantityTypestring · enumRequired

How quantity is interpreted. UNIT = number of units (used for SELL, and for unit-based asset trades). AMOUNT = a EUR cash amount to invest (used for eWP BUY/subscription orders).

Possible values:

tradeSidestring · enumRequiredPossible values:

externalIdstringRequired

External Id in partner's system. This value has to be unique

walletCustomerProductIdstring · uuidRequired

Wallet customer product used for the order.

cashCustomerProductIdstring · uuidRequired

Cash customer product used for the order.

Responses

200

application/json

orderIdstring · uuidRequired

createdOnstring · date-timeRequired

The date denoting when the order's record was initially created.

400

Bad Request

application/json

post/wawex/orders/market

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

{
  "symbol": "TVDY",
  "quantity": 5000,
  "quantityType": "UNIT",
  "tradeSide": "BUY",
  "externalId": "text",
  "walletCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
  "cashCustomerProductId": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "orderId": "123e4567-e89b-12d3-a456-426614174000",
  "createdOn": "2026-07-16T00:17:08.148Z"
}

Create Ex-Ante Document

post

/wawex/ex-ante

Calculate ex-ante costs for a tokenized asset trade and persist the resulting cost-disclosure document (exAnteId + downloadable PDF). For BUY orders, returns purchase, holding, and sale costs. For SELL orders, returns sale costs only.

This optional pre-trade preview lets a partner show the MiFID cost disclosure before placing an order; it does not create an order. An ex-ante is also generated automatically on every order (POST /wawex/orders/market), so calling this first is not required.

For eWP / TVDY, the ex-ante is priced from the indicative NAV → EUR price (eWP has no ISIN, so no ISIN lookup is performed) and the returned asset.assetType is eWP. BUY uses quantityType: AMOUNT (EUR), SELL uses quantityType: UNIT.

Authorizations

HTTPRequired

Header parameters

Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Body

symbolstringRequired

Trading symbol of the tokenized asset (e.g. TVDY for eWP).

Example: TVDY

tradeSidestring · enumRequiredPossible values:

quantityTypestring · enumRequired

How quantity is interpreted. UNIT = number of units (used for SELL, and for unit-based asset trades). AMOUNT = a EUR cash amount to invest (used for eWP BUY/subscription orders).

Possible values:

quantitynumber · decimalRequired

Order quantity (decimal values allowed)

orderTypestring · enumRequiredPossible values:

Responses

200

application/json

exAnteIdstring · uuidRequired

createdOnstring · date-timeRequired

400

Bad Request

application/json

404

Not Found

application/json

post/wawex/ex-ante

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

{
  "symbol": "TVDY",
  "tradeSide": "BUY",
  "quantityType": "UNIT",
  "quantity": 1,
  "orderType": "MARKET"
}

{
  "exAnteId": "123e4567-e89b-12d3-a456-426614174000",
  "createdOn": "2026-07-16T00:17:08.148Z",
  "asset": {
    "symbol": "text",
    "description": "text",
    "assetType": "TRACKER_CERTIFICATE"
  },
  "order": {
    "quantity": 1,
    "tradeSide": "BUY",
    "exchangeCode": "TVM",
    "grossAmount": 1,
    "pricePerUnit": 1,
    "currency": "EUR"
  },
  "purchaseCosts": {
    "currency": "EUR",
    "feeAmount": 1,
    "percent": 1
  },
  "productCosts": {
    "currency": "EUR",
    "ter": 1,
    "percent": 1
  },
  "saleCosts": {
    "currency": "EUR",
    "feeAmount": 1,
    "percent": 1
  },
  "total": {
    "productCosts": {
      "currency": "EUR",
      "ter": 1,
      "percent": 1
    },
    "transactionFees": {
      "currency": "EUR",
      "feeAmount": 1,
      "percent": 1
    },
    "grants": {
      "currency": "EUR",
      "grantsAmount": 1,
      "percent": 1
    }
  },
  "timeline": {
    "year1": {
      "currency": "EUR",
      "feeAmount": 1,
      "percent": 1
    },
    "fromYear2": {
      "currency": "EUR",
      "ter": 1,
      "percent": 1
    },
    "yearOfSale": {
      "currency": "EUR",
      "feeAmount": 1,
      "percent": 1
    }
  },
  "metaInfo": {
    "disclaimer": "text",
    "explanation": "text"
  }
}

Get Ex-Ante Receipt

get

/wawex/ex-ante/{exAnteId}/receipt

Download the ex-ante cost disclosure PDF for the given exAnteId.

Authorizations

HTTPRequired

Path parameters

exAnteIdstring · uuidRequired

Ex-ante document identifier

Responses

200

application/pdf

string · binaryOptional

404

Not Found

application/json

get/wawex/ex-ante/{exAnteId}/receipt

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

binary

Get Order

get

/wawex/orders/{orderId}

Get order details by ID

Authorizations

HTTPRequired

Path parameters

orderIdstring · uuidRequired

Order ID

Responses

200

application/json

orderIdstring · uuidRequired

The identifier of the order.

exAnteIdstring · uuidRequired

The identifier of the ex-ante cost-disclosure document auto-generated and linked when the order was created. Download the PDF at GET /wawex/ex-ante/{exAnteId}/receipt.

createdOnstring · date-timeRequired

The timestamp when the order was received.

modifiedOnstring · date-timeRead-onlyRequired

The timestamp when the order has changed the status.

statusundefined · enumRequiredPossible values:

messagestringOptional

externalIdstringRequired

External Id in partner's system. This value has to be unique

tradeSidestring · enumRequiredPossible values:

walletCustomerProductIdstring · uuidRequired

The identifier of the wallet customer product.

cashCustomerProductIdstring · uuidRequired

Cash customer product used for the order.

symbolstringRequired

Trading symbol of the tokenized asset.

quantitynumberRequired

Number of units ordered.

quantityTypestring · enumRequired

How quantity is interpreted. UNIT = number of units (used for SELL, and for unit-based asset trades). AMOUNT = a EUR cash amount to invest (used for eWP BUY/subscription orders).

Possible values:

orderTypestring · enumRequiredPossible values:

exchangeCodestring · enumRequiredPossible values:

400

Bad Request

application/json

404

Not Found

application/json

get/wawex/orders/{orderId}

GET /wawex/orders/{orderId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "orderId": "123e4567-e89b-12d3-a456-426614174000",
  "exAnteId": "123e4567-e89b-12d3-a456-426614174000",
  "createdOn": "2026-07-16T00:17:08.148Z",
  "modifiedOn": "2026-07-16T00:17:08.148Z",
  "status": "RECEIVED",
  "message": "text",
  "externalId": "text",
  "tradeSide": "BUY",
  "walletCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
  "cashCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
  "symbol": "text",
  "quantity": 1,
  "quantityType": "UNIT",
  "orderType": "MARKET",
  "exchangeCode": "TVM",
  "execution": {
    "executionPrice": 1,
    "executionQuantity": 1,
    "remainingQuantity": 1,
    "valueDate": "2026-07-16",
    "bookingDate": "2026-07-16",
    "transactionTime": "2026-07-16T00:17:08.148Z",
    "amount": 1,
    "feeAmount": 1,
    "feeDescription": "text",
    "germanCit": 1,
    "solidaritySurcharge": 1,
    "churchTax": 1,
    "amountCurrency": "EUR"
  },
  "partialExecutions": [
    {
      "executionId": "123e4567-e89b-12d3-a456-426614174000",
      "executionPrice": 1,
      "executionQuantity": 1,
      "amount": 1,
      "executionTime": "2026-07-16T00:17:08.148Z",
      "valueDate": "2026-07-16",
      "bookingDate": "2026-07-16",
      "status": "RECEIVED",
      "taxData": [
        {
          "germanCit": 1,
          "solidaritySurcharge": 1,
          "churchTax": 1
        }
      ],
      "feeAmount": 1,
      "feeDescription": "text"
    }
  ]
}

Cancel Order

delete

/wawex/orders/{orderId}

Cancel an existing order.

For eWP / TVDY orders this is the only cancellation path: a partner may cancel a still-pending order until its batch is closed by Ops. Cancellation releases the order's EUR (BUY) or unit (SELL) block. Once the batch has been closed the order can no longer be cancelled and the request fails.

Authorizations

HTTPRequired

Path parameters

orderIdstring · uuidRequired

Order ID

Header parameters

Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Responses

200

application/json

object · CancelOrderResultOptional

400

Bad Request

application/json

404

Not Found

application/json

delete/wawex/orders/{orderId}

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

{}

Get Orders

get

/wawex/products/{customerProductId}/orders

Get list of orders with optional filtering

Authorizations

HTTPRequired

Path parameters

customerProductIdstring · uuidRequired

Query parameters

cursorstringOptional

String value used for pagination

limitinteger · min: 1Optional

Maximum number of items to return

Default: 20

startCreatedOnstring · date-timeOptional

Display orders created on or after this date

endCreatedOnstring · date-timeOptional

Display orders created on or before this date

Responses

200

application/json

400

Bad Request

application/json

404

Not Found

application/json

get/wawex/products/{customerProductId}/orders

GET /wawex/products/{customerProductId}/orders HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {
      "orderId": "123e4567-e89b-12d3-a456-426614174000",
      "exAnteId": "123e4567-e89b-12d3-a456-426614174000",
      "createdOn": "2026-07-16T00:17:08.148Z",
      "modifiedOn": "2026-07-16T00:17:08.148Z",
      "status": "RECEIVED",
      "message": "text",
      "externalId": "text",
      "tradeSide": "BUY",
      "walletCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
      "cashCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
      "symbol": "text",
      "quantity": 1,
      "quantityType": "UNIT",
      "orderType": "MARKET",
      "exchangeCode": "TVM",
      "execution": {
        "executionPrice": 1,
        "executionQuantity": 1,
        "remainingQuantity": 1,
        "valueDate": "2026-07-16",
        "bookingDate": "2026-07-16",
        "transactionTime": "2026-07-16T00:17:08.148Z",
        "amount": 1,
        "feeAmount": 1,
        "feeDescription": "text",
        "germanCit": 1,
        "solidaritySurcharge": 1,
        "churchTax": 1,
        "amountCurrency": "EUR"
      },
      "partialExecutions": [
        {
          "executionId": "123e4567-e89b-12d3-a456-426614174000",
          "executionPrice": 1,
          "executionQuantity": 1,
          "amount": 1,
          "executionTime": "2026-07-16T00:17:08.148Z",
          "valueDate": "2026-07-16",
          "bookingDate": "2026-07-16",
          "status": "RECEIVED",
          "taxData": [
            {
              "germanCit": 1,
              "solidaritySurcharge": 1,
              "churchTax": 1
            }
          ],
          "feeAmount": 1,
          "feeDescription": "text"
        }
      ]
    }
  ],
  "pagination": {
    "cursor": "text",
    "limit": 1
  }
}

Last updated 2 months ago