Open Pending Trade

MngOpenPendingTrade

Description: Opens a new pending trade on behalf of the manager.

This method follows the common Trade Request Lifecycle. A successful response is an acknowledgment of accepted processing, not a guarantee that the pending order has already been activated.

Access Control

Requires dealer_trades for manager/dealer sessions. The target account must also match the manager groups and brand scope loaded from the cached manager record. Token payload is used only for manager id and session type.

Request Parameters

Name	Type	Required	Description
login	int	Yes	User login ID
cmd	int	Yes	Pending command only (OP_BUY_LIMIT=2, OP_SELL_LIMIT=3, OP_BUY_STOP=4, OP_SELL_STOP=5)
volume	int	Yes	Trade volume in minimal lots
symbol	string	Yes	Trading instrument
sl	double	Yes	Stop Loss value
tp	double	Yes	Take Profit value
open_price	double	Yes	Pending activation price
open_time	int64	No	Optional trade open timestamp
expiration	int64	No	Optional pending expiration time
comment	string	No	Optional comment for the trade
__access	object	Yes	Access object with type field

Response Parameters

In the raw TCP response envelope, the fields below are returned inside data.

Name	Type	Description
accepted	bool	Always true on successful acknowledgment
order	int	Reserved order identifier for tracking the pending order lifecycle
login	int	Target account login
symbol	string	Requested symbol
cmd	int	Requested pending command
volume	int	Requested trade volume in minimal lots
state	int	Accepted request state, typically TS_OPEN_REQUEST

Response Example

{
  "extID": "open-pending-1",
  "status": 200,
  "data": {
    "accepted": true,
    "order": 1001234,
    "state": 1,
    "login": 123456,
    "symbol": "EURUSD",
    "cmd": 2,
    "volume": 1000
  }
}

Lifecycle Notes

• The immediate response is not a final activation report.
• The pending order should be tracked by order.
• Final activation or cancellation is observed through trade events and trade queries.