Start Order Strategy | Partner Developer Platform

Start a multi-bracket trading strategy.

This endpoint is used with a WebSocket. You can create any number of brackets and add them to brackets field on the params object as a JSON string.

1 const URL = 'wss://demo.tradovateapi.com/v1/websocket'
2 
3 const params = {
4     entryVersion: {
5         orderQty: 1,
6         orderType: "Market"
7     },
8     brackets: [{
9         qty: 1,
10         profitTarget: -30,
11         stopLoss: 15,
12         trailingStop: false
13     }]
14 }
15 
16 const body = {
17     accountId: myAcctId,
18     accountSpec: name,
19     symbol: 'MESM1',
20     action: 'Sell',
21     orderStrategyTypeId: 2, //2 is 'multibracket', we currently only offer this strategy but more may exist in the future.
22     params: JSON.stringify(params)
23 }
24 
25 const mySocket = new WebSocket(URL)
26 
27 //authorize socket using your access token
28 mySocket.onopen = function() {
29     mySocket.send(`authorize\n0\n\n${accessToken}`)
30 }
31 
32 mySocket.send(`orderstrategy/startorderstrategy\n4\n\n${JSON.stringify(body)}`)

For more details about working with advanced order types, see placeOrder, placeOCO, and placeOSO.

### Start a multi-bracket trading strategy. This endpoint is used with a WebSocket. You can create any number of brackets and add them to `brackets` field on the `params` object as a JSON string. ```js const URL = 'wss://demo.tradovateapi.com/v1/websocket' const params = { entryVersion: { orderQty: 1, orderType: "Market" }, brackets: [{ qty: 1, profitTarget: -30, stopLoss: 15, trailingStop: false }] } const body = { accountId: myAcctId, accountSpec: name, symbol: 'MESM1', action: 'Sell', orderStrategyTypeId: 2, //2 is 'multibracket', we currently only offer this strategy but more may exist in the future. params: JSON.stringify(params) } const mySocket = new WebSocket(URL) //authorize socket using your access token mySocket.onopen = function() { mySocket.send(`authorize\n0\n\n${accessToken}`) } mySocket.send(`orderstrategy/startorderstrategy\n4\n\n${JSON.stringify(body)}`) ``` For more details about working with advanced order types, see [placeOrder](/#operation/placeOrder), [placeOCO](/#operation/placeOCO), and [placeOSO](/#operation/placeOSO).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

symbolstringRequired<=64 characters

orderStrategyTypeIdlongRequired

actionenumRequired

Buy, Sell

Allowed values:

accountIdlongOptional

accountSpecstringOptional<=64 characters

paramsstringOptional<=8192 characters

uuidstringOptional<=64 characters

customTag50stringOptional<=64 characters

isAutomatedbooleanOptional

Response

OrderStrategyStatusResponse

errorTextstring or null<=8192 characters

Non-empty if the request failed

failureReasonenum or null

AccountClosed, AdvancedTrailingStopUnsupported, AnotherCommandPending, BackMonthProhibited, ExecutionProviderNotConfigured, ExecutionProviderUnavailable, InvalidContract, InvalidPrice, KeyInformationDocumentRequired, LiquidationOnly, LiquidationOnlyBeforeExpiration, MaxOrderQtyIsNotSpecified, MaxOrderQtyLimitReached, MaxPosLimitMisconfigured, MaxPosLimitReached, MaxTotalPosLimitReached, MultipleAccountPlanRequired, NoQuote, NotEnoughLiquidity, OtherExecutionRelated, ParentRejected, RiskCheckTimeout, SSFRiskDisclosureAcknowledgmentRequired, SessionClosed, Success, TooLate, TradingLocked, TrailingStopNonOrderQtyModify, Unauthorized, UnknownReason, Unsupported

orderStrategyobject or null

Start a multi-bracket trading strategy.

This endpoint is used with a WebSocket. You can create any number of brackets and add them to brackets field on the params object as a JSON string.

1 const URL = 'wss://demo.tradovateapi.com/v1/websocket'
2 
3 const params = {
4     entryVersion: {
5         orderQty: 1,
6         orderType: "Market"
7     },
8     brackets: [{
9         qty: 1,
10         profitTarget: -30,
11         stopLoss: 15,
12         trailingStop: false
13     }]
14 }
15 
16 const body = {
17     accountId: myAcctId,
18     accountSpec: name,
19     symbol: 'MESM1',
20     action: 'Sell',
21     orderStrategyTypeId: 2, //2 is 'multibracket', we currently only offer this strategy but more may exist in the future.
22     params: JSON.stringify(params)
23 }
24 
25 const mySocket = new WebSocket(URL)
26 
27 //authorize socket using your access token
28 mySocket.onopen = function() {
29     mySocket.send(`authorize\n0\n\n${accessToken}`)
30 }
31 
32 mySocket.send(`orderstrategy/startorderstrategy\n4\n\n${JSON.stringify(body)}`)

For more details about working with advanced order types, see placeOrder, placeOCO, and placeOSO.

1	curl -X POST https://demo-d.tradovateapi.com/v1/orderStrategy/startorderstrategy \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"symbol": "string",
6	"orderStrategyTypeId": 1,
7	"action": "Buy"
8	}'

1	{
2	"errorText": "string",
3	"failureReason": "AccountClosed",
4	"orderStrategy": {
5	"accountId": 1,
6	"timestamp": "2024-01-15T09:30:00Z",
7	"contractId": 1,
8	"orderStrategyTypeId": 1,
9	"action": "Buy",
10	"status": "ActiveStrategy",
11	"id": 1,
12	"initiatorId": 1,
13	"params": "string",
14	"uuid": "string",
15	"failureMessage": "string",
16	"senderId": 1,
17	"customTag50": "string",
18	"userSessionId": 1
19	}
20	}

1	const URL = 'wss://demo.tradovateapi.com/v1/websocket'
2
3	const params = {
4	entryVersion: {
5	orderQty: 1,
6	orderType: "Market"
7	},
8	brackets: [{
9	qty: 1,
10	profitTarget: -30,
11	stopLoss: 15,
12	trailingStop: false
13	}]
14	}
15
16	const body = {
17	accountId: myAcctId,
18	accountSpec: name,
19	symbol: 'MESM1',
20	action: 'Sell',
21	orderStrategyTypeId: 2, //2 is 'multibracket', we currently only offer this strategy but more may exist in the future.
22	params: JSON.stringify(params)
23	}
24
25	const mySocket = new WebSocket(URL)
26
27	//authorize socket using your access token
28	mySocket.onopen = function() {
29	mySocket.send(`authorize\n0\n\n${accessToken}`)
30	}
31
32	mySocket.send(`orderstrategy/startorderstrategy\n4\n\n${JSON.stringify(body)}`)