Orders
Get orders
Authorizations
Path parameters
customerProductIdstring · uuidRequired
Query parameters
cursorstringOptional
String value used for pagination
limitinteger · min: 1OptionalDefault:
Maximum number of items to return
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
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-08-30T17:50:57.036Z",
"modifiedOn": "2025-08-30T17:50:57.036Z",
"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
Authorizations
Path parameters
orderIdstring · uuidRequired
Id of order we're looking for
Responses
200
OK
application/json
400
Bad Request
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-08-30T17:50:57.036Z",
"modifiedOn": "2025-08-30T17:50:57.036Z",
"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
Authorizations
Path parameters
orderIdstring · uuidRequired
Id of order we're looking for
Responses
200
OK
application/pdf
Responsestring · binary
400
Bad Request
application/json
404
Not Found
application/json
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 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
400
Bad Request
application/json
409
Conflict
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-08-30T17:50:57.036Z"
}
Last updated