LogoLogo
  • Home Page
  • Documentation
    • API Overview
    • Partner API Authentication
    • Onboarding
    • Partner Webhooks
    • Status Codes for Financial Operations
    • Prices
  • WEBSOCKETS
    • Websocket Prices
      • Prices
      • Schemas
  • API REFERENCE
    • Authorization
      • Schemas
    • User Management
      • Users
      • Schemas
    • Customers
      • General
      • Legal Entities
      • Natural Persons
      • Customer Labels
      • Search Nace Sectors
      • Onboarding Wizard
      • Schemas
    • Documents
      • Documents
      • Schemas
    • Onboardings
      • Onboarding
      • Offboarding
      • Schemas
    • Products
      • General
      • Schemas
    • Asset Management
      • Trading
        • Assets
        • Schemas
      • Digital assets
        • Create Order
        • General
        • Assets
        • Schemas
      • Strategy
        • Schemas
    • Transaction History
      • Schemas
    • Transfers
      • General
      • Create Incoming Test Transfer
      • Schemas
    • Partner Documents
      • Schemas
    • Webhooks
      • Schemas
  • PARTNER APIS
    • Partner Webhooks
      • Schemas
Powered by GitBook
On this page
  1. API REFERENCE
  2. Asset Management

Trading

Last updated 6 days ago

Cancel Order

delete

Cancel order

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

Unique requestor identification in UUID format

Responses
200
OK
application/json
400
Bad Request
application/json
404
Not Found
application/json
delete
DELETE /trading/order/{orderId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Requestor-ID: 123e4567-e89b-12d3-a456-426614174000
Accept: */*
{
  "modificationId": "123e4567-e89b-12d3-a456-426614174000"
}
  • DELETECancel Order
  • PATCHUpdate Order
  • POSTCreate Market Order
  • POSTCreate Limit Order
  • POSTCreate Stop Order

Update Order

patch

Update Order

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

Unique requestor identification in UUID format

Body
quantityTypeundefined · enumRequiredPossible values:
quantitynumberRequired

Number of shares or order amount

orderTypeundefined · enumRequiredPossible values:
limitPricenumberRequired

Should be set when orderType is PRICELIMIT

expiryTypeundefined · enumRequired
  • GOODFORTHEDAY - Good 'Til end of today
  • GOODFORDATE - Good 'Til Date
  • GOODTILCANCELLED - Good 'Til Cancelled
Possible values:
expiryDatestring · dateOptional

Should be set when expiryType is GOODFORDATE

Responses
200
OK
application/json
400
Bad Request
application/json
404
Not Found
application/json
patch
PATCH /trading/order/{orderId} HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Requestor-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 126

{
  "quantityType": "UNIT",
  "quantity": 1,
  "orderType": "LIMIT",
  "limitPrice": 1,
  "expiryType": "GOODFORTHEDAY",
  "expiryDate": "2025-05-23"
}
{
  "modificationId": "123e4567-e89b-12d3-a456-426614174000"
}

Create Market Order

post

Create a single security market 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.

tradeSideundefined · enumRequiredPossible values:
quantityTypeundefined · enumRequiredPossible values:
exchangeCodeundefined · enumRequiredPossible values:
isinstring · min: 12 · max: 12Required

ISIN of the asset

Example: US38259P5089Pattern: ^[A-Z]{2}[A-Z0-9]{10}$
quantitynumberRequired

Number of shares

externalIdstringRequired

Order id in partner's system. This value has to be unique.

Responses
200
OK
application/json
400
Bad Request
application/json
post
POST /trading/order/market HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
Requestor-ID: 123e4567-e89b-12d3-a456-426614174000
Content-Type: application/json
Accept: */*
Content-Length: 250

{
  "depositoryCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
  "cashCustomerProductId": "123e4567-e89b-12d3-a456-426614174000",
  "tradeSide": "BUY",
  "quantityType": "UNIT",
  "exchangeCode": "TGAT",
  "isin": "US38259P5089",
  "quantity": 1,
  "externalId": "text"
}

No content

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.

tradeSideundefined · enumRequiredPossible values:
quantityTypeundefined · enumRequiredPossible values:
exchangeCodeundefined · 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
400
Bad Request
application/json
post
POST /trading/order/limit HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
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-05-23",
  "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.

tradeSideundefined · enumRequiredPossible values:
quantityTypeundefined · enumRequiredPossible values:
exchangeCodeundefined · 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
400
Bad Request
application/json
post
POST /trading/order/stop HTTP/1.1
Host: tvda-api.platform-test.tradevest.ai
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-05-23",
  "externalId": "text"
}

No content