Get Time and Sales Data

Place OTOCO Order

Place a one-triggers-one-cancels-other (OTOCO) order composed of three orders. All three are submitted at the same time, but the second and third orders — which together form an OCO (one-cancels-other) pair — are only released for execution once the first order fills completely.

Send to POST /v1/accounts/{account_id}/orders with class=otoco.

Leg roles

Title

Description

Leg	Role
`[0]`	Triggering order — submitted immediately
`[1]`	First OCO leg — placed automatically once leg `[0]` fills
`[2]`	Second OCO leg — placed automatically once leg `[0]` fills; cancels leg `[1]` (or vice versa) once either fills

Which fields are required per order type

Because legs [1] and [2] form an OCO pair, market is not a valid type for either of them (see the OCO order documentation for why). The triggering order (type[0]) also cannot be market:

Title

Description

Title

`type[index]`	`price[index]` required?	`stop[index]` required?
`limit`	Yes	No
`stop`	No	Yes
`stop_limit`	Yes	Yes

Example: buy with an automatic take-profit / stop-loss bracket

Buy 10 shares of AAPL with a limit order, and once that buy fills, automatically place a bracket (OCO) exit — a limit sell to take profit or a stop sell to cut losses, whichever triggers first:

Leg 0 (triggering order): type[0]=limit, side[0]=buy, quantity[0]=10, price[0]=130 — buy AAPL if it can be bought at $130 or better.
Leg 1 (first OCO leg): type[1]=limit, side[1]=sell, quantity[1]=10, price[1]=150 — once the buy fills, sell if AAPL rises to $150 (take profit).
Leg 2 (second OCO leg): type[2]=stop, side[2]=sell, quantity[2]=10, stop[2]=120 — once the buy fills, sell if AAPL falls to $120 (stop loss).

Once leg 0 fills, legs 1 and 2 become active as an OCO pair: whichever fills first automatically cancels the other.

Header Parameters

Content-Typestring Required

Request content type

Enum values:

application/x-www-form-urlencoded

Authorizationstring Required

Path Parameters

account_idstring Required

ID of the account

Body Parameters

classstring Required

Order class identifier

Enum values:

otoco

durationstring

Time the order will remain active. One of: day, gtc, pre, post. Alternatively, it can also be sent per leg (duration[index]) as long as the main duration is omitted.

Enum values:

daygtcprepost

symbol[0]string

The underlying security symbol, use for equities legs

Show child attributes

quantity[0]number Required

The number of contracts for the option leg

type[0]string Required

The type of order to be placed. First order, one of: limit, stop, stop_limit

Enum values:

limitstopstop_limit

option_symbol[0]string

OCC option symbol of the option, use for option legs

Show child attributes

side[0]string Required

The side of the leg. Equity orders, one of: buy, buy_to_cover, sell, sell_short Option orders, one of: buy_to_open, buy_to_close, sell_to_open, sell_to_close

Enum values:

buybuy_to_coversellsell_shortbuy_to_openbuy_to_closesell_to_opensell_to_close

price[0]number

Limit price. Required only for limit, stop_limit, debit and credit orders.

stop[0]number

Stop price. Required only for stop and stop_limit orders.

symbol[1]string

The underlying security symbol, use for equities legs

option_symbol[1]string

OCC option symbol of the option

Show child attributes

quantity[1]number Required

The number of contracts for the option leg

type[1]string Required

The type of order to be placed. Second leg (first OCO leg), one of: limit, stop, stop_limit

Enum values:

limitstopstop_limit

side[1]string Required

The side of the leg. Equity orders, one of: buy, buy_to_cover, sell, sell_short Option orders, one of: buy_to_open, buy_to_close, sell_to_open, sell_to_close

Enum values:

buybuy_to_coversellsell_shortbuy_to_openbuy_to_closesell_to_opensell_to_close

price[1]number

Limit price. Required only for limit, stop_limit, debit and credit orders.

stop[1]number

Stop price. Required only for stop and stop_limit orders.

symbol[2]string

The underlying security symbol, use for equities legs

option_symbol[2]string

OCC option symbol of the option, use for option legs

Show child attributes

quantity[2]number Required

The number of contracts for the option leg

type[2]string Required

The type of order to be placed. Third leg (second OCO leg), one of: limit, stop, stop_limit

Enum values:

limitstopstop_limit

side[2]string Required

The side of the leg. Equity orders, one of: buy, buy_to_cover, sell, sell_short Option orders, one of: buy_to_open, buy_to_close, sell_to_open, sell_to_close

Enum values:

buybuy_to_coversellsell_shortbuy_to_openbuy_to_closesell_to_opensell_to_close

price[2]number

Limit price. Required only for limit, stop_limit, debit and credit orders.

stop[2]number

Stop price. Required only for stop and stop_limit orders.

tagstring

User-defined tag for the order

previewboolean

When true, validates the order without submitting it

Response

200

Object

Order response information

Response Attributes

orderobject

Show child attributes

400

Object

Invalid request parameters or body

401

Object

Authentication required or invalid credentials

403

Object

Access denied to the requested resource

404

Object

The requested resource was not found

Sections

Place OTOCO Order

Leg roles

Which fields are required per order type

Example: buy with an automatic take-profit / stop-loss bracket

Header Parameters

Path Parameters

Body ParametersExpand all

ResponseExpand all

Response Attributes

Response

Body Parameters

Response