Place OSO

Place an OSO (order-sends-order) 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 OSO strategy places a primary order that, once filled, automatically submits one or two bracket orders — for example, an entry order that sends a take-profit when it fills. Provide the primary order’s fields plus bracket1 (required) and, optionally, bracket2. If you specify both brackets, they’re linked to each other as an OCO, so filling one cancels the other. On success, the response includes the primary order’s orderId.

// Demo environment; for Live use https://live.tradovateapi.com/v1
const URL = 'https://demo.tradovateapi.com/v1'
const oso = {
    accountSpec: yourUserName,
    accountId: yourAccountId,
    action: "Buy",
    symbol: "MESM1",
    orderType: "Limit",
    price: 4150.00,
    orderQty: 1,
    isAutomated: true,
    bracket1: {
        action: "Sell",
        orderType: "Limit",
        price: 4200.00
    }
}
const result = await fetch(`${URL}/order/placeoso`, {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${myAccessToken}`
    },
    body: JSON.stringify(oso)
}).then(res => res.json()) // { orderId } on success

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 primary order (for example, MaxPosLimitReached).
• A contract or price is invalid for the primary order or a bracket (InvalidContract, InvalidPrice).
• The trading session is closed (SessionClosed).

Error Messages

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