Sign in

v57

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-07-2161198428.4 KB
Orders

Submit Orders

Submit new orders

post/v1/accounts/{account_id}/orders

Path parameters

account_idinteger required

Account identifier

Request body

expires_atstring date-time nullable

The timestamp when the order should expire (UTC). Required when time_in_force is GOOD_TILL_DATE.

extended_hoursboolean nullable

Allow trading outside regular trading hours. Some brokers disallow options outside RTH.

idstring nullable

Optional client-provided unique ID (idempotency). Required to be unique per account.

limit_offsetstring nullable

Limit offset for trailing stop-limit orders (signed)

limit_pricestring nullable

Limit price (required for LIMIT and STOP_LIMIT orders)

order_type'MARKET' | 'LIMIT' | 'STOP' | 'STOP_LIMIT' | 'TRAILING_STOP' | 'TRAILING_STOP_LIMIT' required

Strict order-type enum for order submission/replacement requests.

quantitystring required

Quantity to trade. For COMMON_STOCK: shares (may be fractional if supported). For OPTION (single-leg): contracts (must be an integer)

side'BUY' | 'SELL' | 'SELL_SHORT' | 'OTHER' required

Side of an order

stop_pricestring nullable

Stop price (required for STOP and STOP_LIMIT orders)

symbolstring nullable

Trading symbol. For equities, use the ticker symbol (e.g., "TSLA"). For options, use the OSI symbol (e.g., "TSLA 250117C00190000"). Either symbol or instrument_id must be provided.

time_in_force'DAY' | 'GOOD_TILL_CANCEL' | 'IMMEDIATE_OR_CANCEL' | 'FILL_OR_KILL' | 'GOOD_TILL_DATE' | 'AT_THE_OPENING' | 'AT_THE_CLOSE' | 'GOOD_TILL_CROSSING' | 'GOOD_THROUGH_CROSSING' | 'AT_CROSSING' required

Strict time-in-force enum for order submission requests.

trailing_offsetstring nullable

Trailing offset amount (required for trailing orders)

trailing_offset_type'PRICE' | 'BPS'

Trailing offset type for trailing stop orders.

Example request

[
  {
    "order_type": "MARKET",
    "quantity": "1",
    "side": "BUY",
    "symbol": "TSLA",
    "time_in_force": "DAY"
  }
]

Response

Orders submitted successfully

Example response

{
  "error": {
    "code": 400,
    "message": "Order quantity must be greater than zero"
  },
  "data": [
    {
      "account_id": 19816,
      "client_order_id": "my-ref-id-20251001-001",
      "created_at": "2025-10-31T13:30:00.000000000Z",
      "extended_hours": false,
      "filled_quantity": "0",
      "id": "0195f6c7-4f64-7e3c-8b0a-1d8e4f5e6a7b",
      "instrument_id": "d4d5d6d7-e4e5-f4f5-a4a5-a6a7a8a9aaab",
      "instrument_type": "COMMON_STOCK",
      "leaves_quantity": "1",
      "limit_price": "48.00",
      "order_type": "LIMIT",
      "quantity": "1",
      "side": "BUY",
      "status": "PENDING_NEW",
      "stop_price": null,
      "symbol": "TSLA",
      "time_in_force": "DAY",
      "updated_at": "2025-10-31T13:30:00.000000000Z",
      "venue": "XNAS"
    }
  ]
}