Get Time and Sales Data

Place OTO Order

Place a one-triggers-other (OTO) order composed of two orders. Both orders are submitted at the same time, but the second order is only released for execution once the first order fills completely — the second order is placed only after the first order executes.

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

Leg roles

Title

Description

Leg	Role
`[0]`	Triggering order — submitted immediately
`[1]`	Triggered order — placed automatically once leg `[0]` fills

Which fields are required per order type

Title

Description

Title

`type[index]`	`price[index]` required?	`stop[index]` required?
`market` (leg `[1]` only)	No	No
`limit`	Yes	No
`stop`	No	Yes
`stop_limit`	Yes	Yes

Note: market is only a valid type for the triggered order (type[1]); the triggering order (type[0]) must be limit, stop, or stop_limit.

Example

Buy 10 shares of AAPL with a limit order, and once that buy fills, automatically place a limit sell order to take profit:

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 (triggered order): type[1]=limit, side[1]=sell, quantity[1]=10, price[1]=150 — once the buy fills, automatically place a sell order at $150.

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:

oto

durationstring Required

Time the order will remain active. One of: day, gtc, pre, post. For different durations per leg, duration can be specified as 0 indexed positions, ie duration[0]=day&duration[1]=gtc

Enum values:

daygtcprepost

symbol[0]string Required

The underlying security symbol

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

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 Required

The underlying security symbol

quantity[1]number Required

The number of contracts for the option leg

type[1]string Required

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

Enum values:

marketlimitstopstop_limit

option_symbol[1]string

OCC option symbol of the option

Show child attributes

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.

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 OTO Order

Leg roles

Which fields are required per order type

Example

Header Parameters

Path Parameters

Body ParametersExpand all

ResponseExpand all

Response Attributes

Response

Body Parameters

Response