Skip to main content

Place pending order

POST 
/v1/trading/accounts/:account_id/orders

Creates a new pending order or sets SL/TP for a position with a new SLTP order. Order type may be:

  • limit
  • stop
  • sltp

Market orders are not accepted by this method. To open a position with immediate execution, use POST /v1/trading/accounts/{account_id}/positions.

Runtime restrictions:

  • unavailable if trade_mode is trading_disabled
  • unavailable if account_status is close_only, except for SLTP orders

Instrument-specific request validation:

  • resolve validation inputs from GET /v1/configuration/accounts/{account_id}/instruments/{instrument}/conditions
  • volume must satisfy volume_min, volume_max, and volume_step
  • request price fields (price, stop_loss_price, take_profit_price) must use at most point_digits fractional digits
  • the implied minimum price increment is 10^-point_digits

The method returns ACK response. Final transaction result is delivered through Server Events.

Consistency and recovery notes:

  • Closed positions and final-state orders are retained for 1 month (subject to clarification).
  • If operation_id is not received in the REST ACK response, or is not received in Server events subscription, or an unknown operation_id is received, the client should restart Server events subscription and reconcile state using snapshots of currently open positions and pending orders.

Business errors:

  • Requote
  • Reject
  • Cancel (trading disabled)
  • Invalid (instrument, account is not found, internal error, invalid request parameters)
  • InvalidVolume
  • InvalidSLTP
  • TradingDisabled (readOnly mode, account was disabled)
  • MarketClosed
  • NoMoney
  • PriceOff
  • TooManyTradeRequests
  • ConnectionError
  • Close Only

Request​

Responses​

ACK