Digital assets

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

400

Bad Request

application/json

get

HTTPcURLJavaScriptPython

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

{
  "data": [
    {
      "quote": {
        "quoteId": "123e4567-e89b-12d3-a456-426614174000",
        "quantity": {
          "unit": 1,
          "amount": 1
        },
        "price": 1,
        "expiresAt": "2025-06-16T11:40:52.488Z",
        "cryptoSymbol": "text",
        "tradeSide": "BUY",
        "currency": "EUR",
        "createdOn": "2025-06-16T11:40:52.488Z"
      },
      "status": "RECEIVED",
      "side": "BUY",
      "orderId": "123e4567-e89b-12d3-a456-426614174000",
      "walletCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
      "message": "text",
      "createdOn": "2025-06-16T11:40:52.488Z",
      "modifiedOn": "2025-06-16T11:40:52.488Z",
      "externalId": "text",
      "orderType": "MARKET",
      "marketOrderData": {
        "symbol": "text",
        "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

400

Bad Request

application/json

get

HTTPcURLJavaScriptPython

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

{
  "quote": {
    "quoteId": "123e4567-e89b-12d3-a456-426614174000",
    "quantity": {
      "unit": 1,
      "amount": 1
    },
    "price": 1,
    "expiresAt": "2025-06-16T11:40:52.488Z",
    "cryptoSymbol": "text",
    "tradeSide": "BUY",
    "currency": "EUR",
    "createdOn": "2025-06-16T11:40:52.488Z"
  },
  "status": "RECEIVED",
  "side": "BUY",
  "orderId": "123e4567-e89b-12d3-a456-426614174000",
  "walletCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
  "message": "text",
  "createdOn": "2025-06-16T11:40:52.488Z",
  "modifiedOn": "2025-06-16T11:40:52.488Z",
  "externalId": "text",
  "orderType": "MARKET",
  "marketOrderData": {
    "symbol": "text",
    "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

400

Bad Request

application/json

404

Not Found

application/json

get

HTTPcURLJavaScriptPython

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

No content

Request Quote

post

The “Request Quote“ endpoint is used for Orders and Collective orders with orderType = RfQ.

RfQ order type means Request for Quote order type. An order has the RfQ order type if the order was created via requesting and accepting a quoted price.

Authorizations

Header parameters

Requestor-IDstring · uuidRequired

Unique requestor identification in UUID format

Body

Request for a price quote.

cryptoSymbolstringRequired

tradeSidestring · enumRequiredPossible values:

quantityTypestring · enumRequiredPossible values:

quantitynumberRequired

currencystring · enumOptional

Cash currency for amount. Currency code in ISO 4217. It’s specified and required if quantityType = AMOUNT

Possible values:

Responses

200

OK

application/json

400

Bad Request

application/json

post

HTTPcURLJavaScriptPython

POST /digital/quotes 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: 75

{
  "cryptoSymbol": "BTC",
  "tradeSide": "BUY",
  "quantity": 1,
  "quantityType": "UNIT"
}

Buy 1 BTCBuy 1000 eur equivalent of BTCSell half of bitcoinSell the amount of ETH by the cost of 10k EUR

{
  "quoteId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "cryptoSymbol": "BTC",
  "quantity": {
    "unit": 1.12345678,
    "amount": 45179.02
  },
  "price": 40214.293,
  "expiresAt": "2009-11-10T23:00:00Z",
  "tradeSide": "BUY",
  "currency": "EUR",
  "createdOn": "2009-11-09T23:00:00Z"
}