Skip to main content

Open position

POST 
/v1/trading/accounts/:account_id/positions

Opens a new position using immediate market execution.

This method represents the client intent to open exposure. The resulting transaction may include an order, deal, position and account_state. On position open, account_state may change because used margin is recalculated; if opening commission is charged, balance changes as well.

Runtime restrictions:

  • unavailable if trade_mode is trading_disabled
  • unavailable if account_status is close_only

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
  • Invalid
  • InvalidVolume
  • InvalidSLTP
  • TradingDisabled
  • MarketClosed
  • NoMoney
  • PriceOff
  • TooManyTradeRequests
  • ConnectionError
  • Close Only

Request​

Responses​

ACK