Product Definitions & Fees

Get Product Definitions

get

https://tvda-api.platform-test.tradevest.aihttps://tvda-api.platform-pretest.tradevest.ai

/products

Get product definitions that are already or could be potentially available for partner

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Responses

200

OK

application/json

get

/products

HTTPcURLJavaScriptPython

GET /products HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

200

OK

{
  "data": [
    {
      "name": "text",
      "productType": "CASH",
      "productCode": "WALLET",
      "description": "text",
      "isActive": true
    }
  ]
}

Get Fee Instances

get

https://tvda-api.platform-test.tradevest.aihttps://tvda-api.platform-pretest.tradevest.ai

/products/fees/instances

Get fee instances. If productCode is not provided, returns fees for all products.

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Query parameters

productCodestring · enumOptional

Product code

Possible values:

feeInstanceStatusstring · enumOptional

The status of the fee instance

Possible values:

Responses

200

OK

application/json

feeInstanceIdstring · uuidRead-onlyRequired

Unique identification number in UUID format.

productCodestring · enumRequired

Product code

Possible values:

categorystring · enumRequired

The category of the fee

Possible values:

statusstring · enumRequired

The status of the fee instance

Possible values:

currencystring · enumRequired

Currency of the product's balance. Currency code in ISO 4217

Possible values:

feeTypestring · enumRequired

The type of the fee

Possible values:

feeTriggerstring · enumRequired

The trigger of the fee

Possible values:

feeFrequencystring · enumOptional

The frequency of the fee

Possible values:

feeCollectionstring · enumRequired

The collection of the fee

Possible values:

partnerIdstring · uuidRequired

Unique identification number in UUID format.

feeTriggerEventstring · enumOptional

Fee trigger event, only applicable if feeTrigger = EVENT_BASED

Possible values:

fixedFeeAmountnumberOptional

Fee amount in currency, only applicable if feeType = FIXED

inducementAmountnumberOptional

Inducement amount, only applicable if feeType = FIXED

feeRationumberOptional

Fee amount in percentage, only applicable if feeType = VARIABLE

minFeeAmountnumberOptional

Minimum fee amount to be charged, only applicable if feeType = VARIABLE

maxFeeAmountnumberOptional

Maximum fee amount to be charged only applicable if feeType = VARIABLE

validFromstring · dateRequired

validUntilstring · dateOptional

createdOnstring · date-timeRead-onlyRequired

modifiedOnstring · date-timeRead-onlyRequired

400

Bad Request

application/json

get

/products/fees/instances

HTTPcURLJavaScriptPython

GET /products/fees/instances HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

[
  {
    "feeInstanceId": "123e4567-e89b-12d3-a456-426614174000",
    "productCode": "WALLET",
    "category": "ACCOUNT",
    "status": "ACTIVE",
    "currency": "EUR",
    "feeType": "FIXED",
    "feeTrigger": "EVENT_BASED",
    "feeFrequency": "MONTHLY",
    "feeCollection": "MONTHLY",
    "partnerId": "123e4567-e89b-12d3-a456-426614174000",
    "feeTriggerEvent": "TRADE_WBAH",
    "fixedFeeAmount": 1,
    "inducementAmount": 1,
    "feeRatio": 1,
    "minFeeAmount": 1,
    "maxFeeAmount": 1,
    "validFrom": "2026-03-18",
    "validUntil": "2026-03-18",
    "feeInstanceScales": [
      {
        "feeInstanceScaleId": "123e4567-e89b-12d3-a456-426614174000",
        "feeInstanceScaleStatus": "ACTIVE",
        "scaleType": "INCREMENTAL_SCALE",
        "from": 1,
        "fixedFeeAmount": 1,
        "feeRatio": 1,
        "minFeeAmount": 1,
        "maxFeeAmount": 1,
        "createdOn": "2026-03-18T23:47:12.602Z",
        "modifiedOn": "2026-03-18T23:47:12.602Z"
      }
    ],
    "createdOn": "2026-03-18T23:47:12.602Z",
    "modifiedOn": "2026-03-18T23:47:12.602Z"
  }
]