Orders

Submit a market, limit, or stop order

Submits an order to the command queue for processing. Returns a command_id you can use to track status.

Order types:

market — executes immediately at best available price
limit — executes when price reaches your level or better (requires price)
stop — triggers a market order when price reaches stop level (requires price)

Bracket orders: optionally attach take_profit and/or stop_loss prices. These create child limit/stop orders that auto-cancel each other (OCO) when one fills.

Validation: checks account ownership, trading status, lockout, max contracts rule, and tick size before accepting.

Requires x-idempotency-key header to prevent duplicate submissions.

POST

trade

order

const response = await fetch('/trade/order', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    account_id: 'your-account-uuid',
    contract: 'ESH6',
    side: 'buy',
    quantity: 2
  })
});
const { data } = await response.json();
console.log('Order filled at:', data.order.filled_price);

{
  "accepted": true,
  "command_id": "2f95ccde-3f33-4fa0-a84d-1a9bdf8575ff",
  "status": "queued"
}

{
  "code": "ERROR_CODE",
  "data": null,
  "error": "Error message describing what went wrong",
  "success": false
}

{
  "code": "UNAUTHORIZED",
  "data": null,
  "error": "Invalid or missing JWT token",
  "success": false
}

{
  "code": "LOCKOUT_ACTIVE",
  "data": null,
  "error": "Account is locked out until 2026-03-12T16:00:00Z (mode: timed, 45 minutes remaining)",
  "success": false
}

{
  "code": "NOT_FOUND",
  "data": null,
  "error": "Account not found",
  "success": false
}

{
  "code": "RATE_LIMITED",
  "data": null,
  "error": "Rate limit exceeded for order submissions. Max 10 requests per second per account. Retry after 0.1 seconds.",
  "rate_limit": {
    "limit": 10,
    "remaining": 0,
    "reset": 1711800125,
    "retry_after": 0.1
  },
  "success": false
}

Body

application/json

Order submission request

Submit a market, limit, or stop order for a specific trading account.

Examples

Market Order (immediate execution):

{
"account_id": "550e8400-e29b-41d4-a716-446655440000",
"contract": "ESH6",
"side": "buy",
"quantity": 2
}

Limit Order (execute at specified price or better):

{
"account_id": "550e8400-e29b-41d4-a716-446655440000",
"contract": "ESH6",
"side": "sell",
"quantity": 1,
"order_type": "limit",
"price": 6050.25
}

Stop Order (trigger market order when price reached):

{
"account_id": "550e8400-e29b-41d4-a716-446655440000",
"contract": "NQH6",
"side": "sell",
"quantity": 1,
"order_type": "stop",
"price": 21000.00
}

account_id

string<uuid>

required

UUID of the trading account to place order on (required)

Example:

"550e8400-e29b-41d4-a716-446655440000"

contract

string

required

Contract symbol (e.g., "ESH6" for E-mini S&P 500 March 2026)

Example:

"ESH6"

quantity

integer<int32>

required

Number of contracts to trade (positive integer)

Required range: x >= 1

Example:

2

side

string

required

Order side: "buy" (go long) or "sell" (go short/close long)

Example:

"buy"

order_type

string | null

Order type: "market" (default), "limit", or "stop"

Example:

"market"

price

number<double> | null

Price for limit/stop orders (required for limit/stop, ignored for market)

Example:

6050.25

stop_loss

number<double> | null

Stop loss price for bracket orders (optional). Creates a stop order to close position at this price. For buy orders: SL should be below entry price. For sell orders: SL should be above entry price.

Example:

6000

take_profit

number<double> | null

Take profit price for bracket orders (optional). Creates a limit order to close position at this price. For buy orders: TP should be above entry price. For sell orders: TP should be below entry price.

Example:

6100

Response

Order command accepted for async processing

accepted

boolean

required

command_id

string<uuid>

required

status

string

required

⌘I

const response = await fetch('/trade/order', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    account_id: 'your-account-uuid',
    contract: 'ESH6',
    side: 'buy',
    quantity: 2
  })
});
const { data } = await response.json();
console.log('Order filled at:', data.order.filled_price);

{
  "accepted": true,
  "command_id": "2f95ccde-3f33-4fa0-a84d-1a9bdf8575ff",
  "status": "queued"
}

{
  "code": "ERROR_CODE",
  "data": null,
  "error": "Error message describing what went wrong",
  "success": false
}

{
  "code": "UNAUTHORIZED",
  "data": null,
  "error": "Invalid or missing JWT token",
  "success": false
}

{
  "code": "LOCKOUT_ACTIVE",
  "data": null,
  "error": "Account is locked out until 2026-03-12T16:00:00Z (mode: timed, 45 minutes remaining)",
  "success": false
}

{
  "code": "NOT_FOUND",
  "data": null,
  "error": "Account not found",
  "success": false
}

{
  "code": "RATE_LIMITED",
  "data": null,
  "error": "Rate limit exceeded for order submissions. Max 10 requests per second per account. Retry after 0.1 seconds.",
  "rate_limit": {
    "limit": 10,
    "remaining": 0,
    "reset": 1711800125,
    "retry_after": 0.1
  },
  "success": false
}

Platform API

Trade API

Market Data API

Submit a market, limit, or stop order

Body

Examples

Response