Orders
Get orders
String value used for pagination
Maximum number of items to return
20
External Id in partner's system. This value has to be unique
Display orders created on or after this date
Display orders created on or before this date
OK
Bad Request
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
Id of order we're looking for
OK
Bad Request
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
Id of order we're looking for
OK
Bad Request
Not Found
GET /digital/orders/{orderId}/receipt HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*
No content
Create order.
Unique requestor identification in UUID format
External Id in partner's system. This value has to be unique
Wallet customer product used for the order.
Cash customer product used for the order.
OK
Bad Request
Conflict
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 a single security limit order
Unique requestor identification in UUID format
The identifier of the depository customer product instance
Cash customer product used for the order.
ISIN of the asset
US38259P5089
Pattern: ^[A-Z]{2}[A-Z0-9]{10}$
Number of shares
The limit price for orders of the type 'limit'.
'The order expiration date (last day the order can trade) in the YYYY-MM-DD format. Default value is T+1 year'
Order id in partner's system. This value has to be unique.
OK
Bad Request
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 a single security stop order
Unique requestor identification in UUID format
The identifier of the depository customer product instance
Cash customer product used for the order.
ISIN of the asset
US38259P5089
Pattern: ^[A-Z]{2}[A-Z0-9]{10}$
Number of shares
The stop price for orders of the type 'stop'.
'The order expiration date (last day the order can trade) in the YYYY-MM-DD format. Default value is T+1 year'
Order id in partner's system. This value has to be unique.
OK
Bad Request
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
Unique requestor identification in UUID format
Number of shares or order amount
Currency of the product's balance. Currency code in ISO 4217
The limit price for orders of the type 'limit'.
The stop price for orders of the type 'stop'.
The order expiration date (last day the order can trade) in the YYYY-MM-DD format. Default value is T+1 year.
Accepted
Bad Request
Not Found
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