Create Order

Create Market Order

post

Create order.

Authorizations

Bearer

Header parameters

Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Body

application/json

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

HTTPcURLJavaScriptPython

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"
}

Buy 1 BTCBuy 1000 eur equivalent of BTC

{
  "orderId": "123e4567-e89b-12d3-a456-426614174000",
  "createdOn": "2025-09-12T21:10:53.997Z"
}