Digital assets

Get Orders

get

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

/products/{customerProductId}/digital/orders

Get orders

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Path parameters

customerProductIdstring · uuidRequired

Query parameters

cursorstringOptional

String value used for pagination

limitinteger · min: 1Optional

Maximum number of items to return

Default: 20

externalIdstringOptional

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

startCreatedOnstring · date-timeOptional

Display orders created on or after this date

endCreatedOnstring · date-timeOptional

Display orders created on or before this date

Responses

200

OK

application/json

400

Bad Request

application/json

get

/products/{customerProductId}/digital/orders

HTTPcURLJavaScriptPython

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

{
  "data": [
    {
      "status": "RECEIVED",
      "side": "BUY",
      "orderId": "123e4567-e89b-12d3-a456-426614174000",
      "walletCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
      "message": "text",
      "createdOn": "2026-03-11T00:10:06.258Z",
      "modifiedOn": "2026-03-11T00:10:06.258Z",
      "externalId": "text",
      "orderType": "MARKET",
      "marketOrderData": {
        "symbol": "text",
        "assetType": "CRYPTOCURRENCY",
        "quantityType": "UNIT",
        "quantity": 1
      },
      "executionData": {
        "quantity": 1,
        "executionPrice": 1,
        "executionAmount": 1,
        "feeDescription": "text",
        "feeAmount": 1
      },
      "cashCustomerProductId": "123e4567-e89b-12d3-a456-426614174000"
    }
  ],
  "pagination": {
    "cursor": "text",
    "limit": 1
  }
}

Get Order

get

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

/digital/orders/{orderId}

Get order

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Path parameters

orderIdstring · uuidRequired

Id of order we're looking for

Responses

200

OK

application/json

statusstring · enumRequiredPossible values:

sidestring · enumRequiredPossible values:

orderIdstring · uuidRequired

The identifier of the order.

walletCustomerProductIdstring · uuidRequired

The identifier of the wallet customer product.

messagestringOptional

createdOnstring · date-timeRequired

The timestamp when the order was received.

modifiedOnstring · date-timeRead-onlyRequired

The timestamp when the order has changed the status.

externalIdstringRequired

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

orderTypestring · enumRequiredPossible values:

cashCustomerProductIdstring · uuidRequired

Cash customer product used for the order.

400

Bad Request

application/json

get

/digital/orders/{orderId}

HTTPcURLJavaScriptPython

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

{
  "status": "RECEIVED",
  "side": "BUY",
  "orderId": "123e4567-e89b-12d3-a456-426614174000",
  "walletCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
  "message": "text",
  "createdOn": "2026-03-11T00:10:06.258Z",
  "modifiedOn": "2026-03-11T00:10:06.258Z",
  "externalId": "text",
  "orderType": "MARKET",
  "marketOrderData": {
    "symbol": "text",
    "assetType": "CRYPTOCURRENCY",
    "quantityType": "UNIT",
    "quantity": 1
  },
  "executionData": {
    "quantity": 1,
    "executionPrice": 1,
    "executionAmount": 1,
    "feeDescription": "text",
    "feeAmount": 1
  },
  "cashCustomerProductId": "123e4567-e89b-12d3-a456-426614174000"
}

Get Order Receipt

get

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

/digital/orders/{orderId}/receipt

Get order receipt

Authorizations

Bearer

OAuth2clientCredentialsRequired

Token URL:

Path parameters

orderIdstring · uuidRequired

Id of order we're looking for

Responses

200

OK

application/pdf

string · binaryOptional

400

Bad Request

application/json

404

Not Found

application/json

get

/digital/orders/{orderId}/receipt

HTTPcURLJavaScriptPython

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