Get Time and Sales Data

Place Combo Order

Place a combo order consisting of one equity leg and one or two option legs. Send to POST /v1/accounts/{account_id}/orders with class=combo.

Understanding debit, credit, and even order types

In addition to market, combo orders support three order types that describe the net premium of the combined legs rather than a per-leg limit price:

debit — the trader pays a net premium to enter the position.
credit — the trader receives a net premium for entering the position.
even — no net premium changes hands; the value of the legs bought and sold offsets to zero.

For debit, credit, and even orders, the price field is interpreted as the net premium for the entire order across all legs combined, not a per-leg price.

Which fields are required per order type

Combo orders do not use a stop field; only price applies, and only for the non-market order types:

`type`	`price` required?
`market`	No
`debit`	Yes
`credit`	Yes
`even`	Yes

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:

combo

symbolstring Required

The underlying security symbol

typestring Required

The order type

Enum values:

marketdebitcrediteven

durationstring Required

The order duration

Enum values:

daygtcprepost

pricenumber

The limit price (required for debit and credit orders)

side[0]string Required

The side of the equity leg. One of: buy, buy_to_cover, sell, sell_short

Enum values:

buybuy_to_coversellsell_short

quantity[0]number Required

The quantity of shares for the equity leg

option_symbol[1]string Required

OCC option symbol of the option

Show child attributes

side[1]string Required

The side of the option leg. One of: buy_to_open, buy_to_close, sell_to_open, sell_to_close

Enum values:

buy_to_openbuy_to_closesell_to_opensell_to_close

quantity[1]number Required

The number of contracts for the option leg

option_symbol[2]string

OCC option symbol of the option

Show child attributes

side[2]string

The side of the option leg. One of: buy_to_open, buy_to_close, sell_to_open, sell_to_close

Enum values:

buy_to_openbuy_to_closesell_to_opensell_to_close

quantity[2]number

The number of contracts for the option leg

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

Understanding debit, credit, and even order types

Which fields are required per order type

Header Parameters

Path Parameters

Body ParametersExpand all

ResponseExpand all

Response Attributes

Response

Body Parameters

Response