Place a new investment order

Authorizations

Authorization

string

header

required

HTTP Basic Authentication using the API Key as username and API Secret as password.

Path Parameters

account_id

string<uuid>

required

Example:

"3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b"

Body

application/json

symbol

string

required

The ticker symbol of the asset (e.g., AAPL).

Example:

"AAPL"

side

enum<string>

required

Whether to buy or sell the asset.

Available options:

buy,

sell

Example:

"buy"

type

enum<string>

required

Order type:

market: Executes immediately at current market price
limit: Sets a specific price limit
stop: Stop loss order that triggers at stop price
stop_limit: Stop order with a limit price
trailing_stop: Trailing stop order

Available options:

market,

limit,

stop,

stop_limit,

trailing_stop

Example:

"limit"

time_in_force

enum<string>

required

How long the order remains active:

day: Expires at end of trading day
gtc: Good Till Cancelled - remains active until filled or cancelled
opg: Opening - executes at market open
cls: Closing - executes at market close
ioc: Immediate or Cancel - fills immediately or cancels
fok: Fill or Kill - fills completely or cancels

Available options:

day,

gtc,

opg,

cls,

ioc,

fok

Example:

"day"

market

string

Market identifier (e.g., "NASDAQ", "NYSE"). Optional.

Example:

"NASDAQ"

isin

string

International Securities Identification Number. Optional.

Example:

"US0378331005"

figi

string

Financial Instrument Global Identifier. Optional.

Example:

"BBG000B9XRY4"

qty

string

Quantity of shares to trade (required if notional not provided, required for sell orders).

Example:

"5"

notional

string

Dollar amount to trade (required if qty not provided, only for buy market orders).

Example:

"1000.00"

limit_price

string

Price limit for limit/stop_limit orders (required when type is 'limit' or 'stop_limit').

Example:

"175.00"

stop_price

string

Stop price for stop/stop_limit orders (required when type is 'stop' or 'stop_limit').

Example:

"170.00"

trail_percent

string

Trail percentage for trailing stop orders (required for trailing_stop if trail_price not provided).

Example:

"2.5"

trail_price

string

Trail price for trailing stop orders (required for trailing_stop if trail_percent not provided).

Example:

"5.00"

extended_hours

boolean

default:false

Whether to allow extended hours trading.

Example:

false

client_order_id

string

Optional client-provided identifier for tracking the order.

Example:

"limitorder123"

commission

string

Commission amount to charge (optional).

Example:

"1.00"

commission_type

enum<string>

Commission calculation method:

notional: Charge commission on a per order basis (default)
qty: Charge commission on a per qty/contract basis, pro rated
bps: Percent commission in basis points (up to 2 decimal places)

Available options:

notional,

qty,

bps

Example:

"notional"

Response

Order accepted by the system

string<uuid>

Unique identifier for the order.

Example:

"ord_x9y8z7a6b5c4d3e2"

account_id

string<uuid>

Account ID associated with the order.

Example:

"3d0b0e65-35d3-4dcd-8df7-10286ebb4b4b"

symbol

string

The ticker symbol of the asset.

Example:

"AAPL"

currency

string

ISO 4217 currency code for the asset's trading currency.

Example:

"USD"

qty

string

Quantity of shares ordered (if quantity-based order).

Example:

"5"

notional

string

Notional amount ordered (if notional-based order).

Example:

"1000.00"

side

enum<string>

Whether to buy or sell the asset.

Available options:

buy,

sell

Example:

"buy"

type

enum<string>

Order type.

Available options:

market,

limit,

stop,

stop_limit,

trailing_stop

Example:

"limit"

time_in_force

enum<string>

How long the order remains active.

Available options:

day,

gtc,

opg,

cls,

ioc,

fok

Example:

"day"

limit_price

string

Price limit for limit/stop_limit orders.

Example:

"175.00"

stop_price

string

Stop price for stop/stop_limit orders.

Example:

"170.00"

trail_percent

string

Trail percentage for trailing stop orders.

Example:

"2.5"

trail_price

string

Trail price for trailing stop orders.

Example:

"5.00"

extended_hours

boolean

Whether extended hours trading was enabled.

Example:

false

client_order_id

string

Client-provided identifier for tracking the order.

Example:

"limitorder123"

status

enum<string>

Current status of the order.

Available options:

accepted,

filled,

partially_filled,

canceled,

rejected

Example:

"accepted"

filled_qty

string

Quantity of shares that have been filled.

Example:

"0"

remaining_qty

string

Quantity of shares remaining to be filled.

Example:

"5"

average_price

string

Average price at which shares have been filled.

Example:

"0.00"

commission

string

Commission amount charged.

Example:

"1.00"

commission_type

enum<string>

Commission calculation method used.

Available options:

notional,

qty,

bps

Example:

"notional"

submitted_at

string<date-time>

Timestamp when the order was submitted.

Example:

"2025-10-18T10:30:00Z"

filled_at

string<date-time> | null

Timestamp when the order was completely filled.

Example:

null

canceled_at

string<date-time> | null

Timestamp when the order was canceled.

Example:

null

reject_reason

string | null

Reason for order rejection if applicable.

Example:

null

Overview

Endpoints

Authorizations

Path Parameters

Body

Response