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

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-01-31",
    "validUntil": "2026-01-31",
    "feeInstanceScales": [
      {
        "feeInstanceScaleId": "123e4567-e89b-12d3-a456-426614174000",
        "feeInstanceScaleStatus": "ACTIVE",
        "scaleType": "INCREMENTAL_SCALE",
        "from": 1,
        "fixedFeeAmount": 1,
        "feeRatio": 1,
        "minFeeAmount": 1,
        "maxFeeAmount": 1,
        "createdOn": "2026-01-31T18:12:22.151Z",
        "modifiedOn": "2026-01-31T18:12:22.151Z"
      }
    ],
    "createdOn": "2026-01-31T18:12:22.151Z",
    "modifiedOn": "2026-01-31T18:12:22.151Z"
  }
]