ORDER_SEND Command

Send market or limit orders

Help

{
   "MSG":"HELP",
   "COMMAND":"ORDER_SEND",
   "DESCRIPTION":"Send a pending or market order to the current account",
   "MANDATORY_TAGS_MARKET":[
       "SYMBOL (String)",
       "VOLUME (Double)",
       "TYPE (String)"
   ],
   "OPTIONAL_TAGS_MARKET":[
       "PRICE (Double)",
       "SLIPPAGE",
       "SL (Double)",
      "TP (Double)",
       "COMMENT (String)",
       "MAGIC (Integer)",
       "EXPIRATION (String)",
       "TYPE_FILLING (String)",
       "ASYNC (Boolean)"
   ],
   "MANDATORY_TAGS_PENDING":[
       "SYMBOL (String)",
       "VOLUME (Double)",
       "TYPE (String)",
       "PRICE (Double)"
   ],
   "OPTIONAL_TAGS_PENDING":[
       "SLIPPAGE (Integer)",
       "SL (Double)",
       "TP (Double)",
       "COMMENT (String)",
       "MAGIC (Integer)",
       "EXPIRATION (String)",
       "TYPE_FILLING (String)",
       "ASYNC (Boolean)"
   ],
   "ERROR_ID":0,
   "ERROR_DESCRIPTION":"The operation completed successfully"
}

Market Order Example

Single Line command (necessary for MTsocketAPI):

{"MSG":"ORDER_SEND", "SYMBOL":"EURUSD", "VOLUME": 0.01, "TYPE":"ORDER_TYPE_BUY"}

Same command in Beauty Format:

{
    "MSG":"ORDER_SEND",
    "SYMBOL":"EURUSD",
    "VOLUME": 0.01,
    "TYPE": "ORDER_TYPE_BUY"
}

TYPE values:

ORDER_TYPE_BUY
ORDER_TYPE_SELL
ORDER_TYPE_BUY_LIMIT
ORDER_TYPE_SELL_LIMIT
ORDER_TYPE_BUY_STOP
ORDER_TYPE_SELL_STOP

TYPE_FILLING values (optional):

SYMBOL_FILLING_FOK
SYMBOL_FILLING_IOC
SYMBOL_FILLING_BOC

MTsocketAPI reply:

{
   "MSG":"ORDER_SEND",
   "RETCODE":10009,
   "DEAL":2015118899,
   "ORDER":2020570482,
   "VOLUME":0.10,
   "PRICE":1.064930,
   "BID":1.064890,
   "ASK":1.064930,
   "REQUEST_ID":3136973152,
   "RETCODE_EXTERNAL":0,
   "ERROR_ID":0,
   "ERROR_DESCRIPTION":"The operation completed successfully"
}

Limit Order Example

Single Line command (necessary for MTsocketAPI):

{"MSG":"ORDER_SEND","SYMBOL":"EURUSD","VOLUME":0.02,"SL":1.08,"TYPE":"ORDER_TYPE_SELL_LIMIT","PRICE":1.07,"EXPIRATION":"2022.09.19 19:38"}

Same command in Beauty Format:

{
    "MSG":"ORDER_SEND",
    "SYMBOL":"EURUSD",
    "VOLUME":0.02,
    "SL":1.08,
    "TYPE":"ORDER_TYPE_SELL_LIMIT",
    "PRICE":1.07,
    "EXPIRATION":"2022.09.19 19:38"
}

Note

EXPIRATION tag value must be at least 10 minutes over the actual broker time.

MTsocketAPI reply:

{
   "MSG":"ORDER_SEND",
   "RETCODE":10013,
   "DEAL":0,
   "ORDER":0,
   "VOLUME":0.00,
   "PRICE":0.000000,
   "BID":0.000000,
   "ASK":0.000000,
   "REQUEST_ID":0,
   "RETCODE_EXTERNAL":0,
   "ERROR_ID":4756,
   "ERROR_DESCRIPTION":"Trade request sending failed"
}