Start Order Strategy | Tradovate Partner API

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

Response

OrderStrategyStatusResponse

errorTextstring or null<=8192 characters

Non-empty if the request failed

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.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	"orderStrategy": {
4	"accountId": 1,
5	"timestamp": "2024-01-15T09:30:00Z",
6	"contractId": 1,
7	"orderStrategyTypeId": 1,
8	"action": "Buy",
9	"status": "ActiveStrategy",
10	"id": 1,
11	"initiatorId": 1,
12	"params": "string",
13	"uuid": "string",
14	"failureMessage": "string",
15	"senderId": 1,
16	"customTag50": "string",
17	"userSessionId": 1
18	}
19	}

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)}`)