Place OCO

POST

/order/placeoco

Place an OCO (one-cancels-the-other) order strategy.

Available to: All authenticated users

Environments: Demo, Live

Rate Limit: 1,500 requests per hour, 1-second back-off, counts all requests

An OCO strategy links two orders so that when one fills, the other is automatically cancelled — commonly used to pair a take-profit with a stop-loss. Provide the primary order’s fields (account, action, symbol, orderQty, orderType, and the price fields its type requires), plus an other object describing the linked order. The other order’s own action and orderType determine which price fields it needs. On success, the response includes both an orderId and an ocoId.

1 // Demo environment; for Live use https://live.tradovateapi.com/v1
2 const URL = 'https://demo.tradovateapi.com/v1'
3 
4 const oco = {
5     accountSpec: yourUserName,
6     accountId: yourAccountId,
7     action: "Sell",
8     symbol: "MESM1",
9     orderType: "Limit",
10     price: 4200.00,
11     orderQty: 1,
12     isAutomated: true,
13     other: {
14         action: "Sell",
15         orderType: "Stop",
16         stopPrice: 4100.00
17     }
18 }
19 
20 const result = await fetch(`${URL}/order/placeoco`, {
21     method: 'POST',
22     headers: {
23         'Content-Type': 'application/json',
24         'Authorization': `Bearer ${myAccessToken}`
25     },
26     body: JSON.stringify(oco)
27 }).then(res => res.json()) // { orderId, ocoId } on success

Set isAutomated to true for any order placed by code or an automated process, and false only for an order a human places directly. Misreporting this can violate exchange policies.

As with any order, acceptance is subject to market, exchange, and risk-management rules. When rejected, the response carries a failureReason and failureText.

Common Failure Scenarios

A risk limit blocks the order (for example, MaxPosLimitReached).
A contract or price is invalid (InvalidContract, InvalidPrice).
The trading session is closed (SessionClosed).

Error Messages

`failureReason`	Trigger
`InvalidPrice`	A price is missing or invalid for one of the linked orders’ types.
`MaxPosLimitReached`	The order would exceed the account’s position limit.
`SessionClosed`	The trading session is closed.

See the failureReason enum in the response schema for the complete list of values.

### Place an OCO (one-cancels-the-other) order strategy. **Available to:** All authenticated users **Environments:** Demo, Live **[Rate Limit](/api/authentication#request-rate-limits-and-time-penalties):** 1,500 requests per hour, 1-second back-off, counts all requests An OCO strategy links two orders so that when one fills, the other is automatically cancelled — commonly used to pair a take-profit with a stop-loss. Provide the primary order's fields (account, `action`, `symbol`, `orderQty`, `orderType`, and the price fields its type requires), plus an `other` object describing the linked order. The `other` order's own `action` and `orderType` determine which price fields it needs. On success, the response includes both an `orderId` and an `ocoId`. ```js // Demo environment; for Live use https://live.tradovateapi.com/v1 const URL = 'https://demo.tradovateapi.com/v1' const oco = { accountSpec: yourUserName, accountId: yourAccountId, action: "Sell", symbol: "MESM1", orderType: "Limit", price: 4200.00, orderQty: 1, isAutomated: true, other: { action: "Sell", orderType: "Stop", stopPrice: 4100.00 } } const result = await fetch(`${URL}/order/placeoco`, { method: 'POST', headers: { 'Content-Type': 'application/json', 'Authorization': `Bearer ${myAccessToken}` }, body: JSON.stringify(oco) }).then(res => res.json()) // { orderId, ocoId } on success ``` <Warning> Set `isAutomated` to `true` for any order placed by code or an automated process, and `false` only for an order a human places directly. Misreporting this can violate exchange policies. </Warning> As with any order, acceptance is subject to market, exchange, and risk-management rules. When rejected, the response carries a `failureReason` and `failureText`. **Common Failure Scenarios** - A risk limit blocks the order (for example, `MaxPosLimitReached`). - A contract or price is invalid (`InvalidContract`, `InvalidPrice`). - The trading session is closed (`SessionClosed`). **Error Messages** | `failureReason` | Trigger | |-----------------|---------| | `InvalidPrice` | A price is missing or invalid for one of the linked orders' types. | | `MaxPosLimitReached` | The order would exceed the account's position limit. | | `SessionClosed` | The trading session is closed. | See the `failureReason` enum in the response schema for the complete list of values.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

actionenumRequired

Buy, Sell

symbolstringRequired<=64 characters

orderQtyintegerRequired

orderTypeenumRequired

Limit, LimitIfTouched, MIT, Market, MarketLimit, MarketStopWithProtection, MarketWithProtection, QTS, Stop, StopLimit, TrailingStop, TrailingStopLimit

otherobjectRequired

accountSpecstringOptional<=64 characters

accountIdlongOptional

clOrdIdstringOptional<=64 characters

pricedoubleOptional

stopPricedoubleOptional

limitIfTouchedPricedoubleOptional

maxShowintegerOptional

pegDifferencedoubleOptional

timeInForceenumOptional

Day, FOK, GTC, GTD, IOC

expireTimedatetimeOptional

textstringOptional<=64 characters

activationTimedatetimeOptional

customTag50stringOptional<=64 characters

isAutomatedbooleanOptional

Response

PlaceOcoResult

failureReasonenum

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

failureTextstring<=8192 characters

orderIdlong

ocoIdlong

$	curl -X POST https://demo.tradovateapi.com/v1/order/placeoco \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"action": "Buy",
>	"symbol": "string",
>	"orderQty": 1,
>	"orderType": "Limit",
>	"other": {
>	"action": "Buy",
>	"orderType": "Limit"
>	}
>	}'

1	{
2	"failureReason": "AccountClosed",
3	"failureText": "string",
4	"orderId": 1,
5	"ocoId": 1
6	}

1	// Demo environment; for Live use https://live.tradovateapi.com/v1
2	const URL = 'https://demo.tradovateapi.com/v1'
3
4	const oco = {
5	accountSpec: yourUserName,
6	accountId: yourAccountId,
7	action: "Sell",
8	symbol: "MESM1",
9	orderType: "Limit",
10	price: 4200.00,
11	orderQty: 1,
12	isAutomated: true,
13	other: {
14	action: "Sell",
15	orderType: "Stop",
16	stopPrice: 4100.00
17	}
18	}
19
20	const result = await fetch(`${URL}/order/placeoco`, {
21	method: 'POST',
22	headers: {
23	'Content-Type': 'application/json',
24	'Authorization': `Bearer ${myAccessToken}`
25	},
26	body: JSON.stringify(oco)
27	}).then(res => res.json()) // { orderId, ocoId } on success