Orders

Get Orders

get

Get orders

Authorizations
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
get
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": "2025-09-18T08:54:33.034Z",
      "modifiedOn": "2025-09-18T08:54:33.034Z",
      "externalId": "text",
      "orderType": "MARKET",
      "marketOrderData": {
        "symbol": "text",
        "assetType": "CRYPTOCURRENCY",
        "quantityType": "UNIT",
        "quantity": 1
      },
      "executionData": {
        "quantity": 1,
        "executionPrice": 1,
        "executionAmount": 1
      },
      "cashCustomerProductId": "123e4567-e89b-12d3-a456-426614174000"
    }
  ],
  "pagination": {
    "cursor": "text",
    "limit": 1
  }
}

Get Order

get

Get order

Authorizations
Path parameters
orderIdstring · uuidRequired

Id of order we're looking for

Responses
200

OK

application/json
get
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": "2025-09-18T08:54:33.034Z",
  "modifiedOn": "2025-09-18T08:54:33.034Z",
  "externalId": "text",
  "orderType": "MARKET",
  "marketOrderData": {
    "symbol": "text",
    "assetType": "CRYPTOCURRENCY",
    "quantityType": "UNIT",
    "quantity": 1
  },
  "executionData": {
    "quantity": 1,
    "executionPrice": 1,
    "executionAmount": 1
  },
  "cashCustomerProductId": "123e4567-e89b-12d3-a456-426614174000"
}

Get Order Receipt

get

Get order receipt

Authorizations
Path parameters
orderIdstring · uuidRequired

Id of order we're looking for

Responses
200

OK

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

No content

Create Market Order

post

Create order.

Authorizations
Header parameters
Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Body
cryptoSymbolstringRequired
tradeSidestring · enumRequiredPossible values:
quantityTypestring · enumRequiredPossible values:
quantitynumberRequired
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

OK

application/json
post
POST /digital/orders/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: 172

{
  "cryptoSymbol": "BTC",
  "tradeSide": "BUY",
  "quantity": 1,
  "quantityType": "UNIT",
  "externalId": "unique-external-id",
  "cashCustomerProductId": "714e1ee5-c723-476c-b1db-4d29cd7a0e17"
}
{
  "orderId": "123e4567-e89b-12d3-a456-426614174000",
  "createdOn": "2025-09-18T08:54:33.034Z"
}

Create Limit Order

post

Create a single security limit order

Authorizations
Header parameters
Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Body
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
post
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
Header parameters
Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Body
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
post
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

Update Order

patch

Update Order

Authorizations
Path parameters
orderIdstring · uuidRequired
Header parameters
Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Body
quantityTypestring · enumOptionalPossible values:
quantitynumberOptional

Number of shares or order amount

currencystring · enumOptional

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

Possible values:
orderTypestring · enumOptionalPossible values:
limitPricenumberOptional

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

stopPricenumberOptional

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

expiryDatestring · dateOptional

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

Responses
202

Accepted

patch
PATCH /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
Content-Type: application/json
Accept: */*
Content-Length: 128

{
  "quantityType": "UNIT",
  "quantity": 1,
  "currency": "EUR",
  "orderType": "LIMIT",
  "limitPrice": 1,
  "stopPrice": 1,
  "expiryDate": "2025-09-18"
}

No content

Last updated