Skip to content

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)",
        "MAGICNR (Integer)",
        "EXPIRATION (String)"
    ],
    "MANDATORY_TAGS_PENDING":[
        "SYMBOL (String)",
        "VOLUME (Double)",
        "TYPE (String)",
        "PRICE (Double)"
    ],
    "OPTIONAL_TAGS_PENDING":[
        "SLIPPAGE (Integer)",
        "SL (Double)",
        "TP (Double)",
        "COMMENT (String)",
        "MAGICNR (Integer)",
        "EXPIRATION (String)"
    ]
}

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

MTsocketAPI reply:

{
    "MSG":"ORDER_SEND",
    "TICKET":47098870,
    "ERROR_ID":0,
    "ERROR_DESCRIPTION":"no error"
}



Limit Order Example

Single Line command (necessary for MTsocketAPI):

{"MSG":"ORDER_SEND", "SYMBOL":"EURUSD", "VOLUME":0.02, "SL":1.06,  "TYPE":"ORDER_TYPE_BUY_LIMIT", "PRICE":1.07, "EXPIRATION":"2022.04.12 19:38"}
Same command in Beauty Format:

{
    "MSG":"ORDER_SEND",
    "SYMBOL":"EURUSD",
    "VOLUME":0.02,
    "SL":1.06,
    "TYPE":"ORDER_TYPE_BUY_LIMIT",
    "PRICE":1.07,
    "EXPIRATION":"2022.04.12 19:38"
}

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

MTsocketAPI reply:

{
    "MSG":"ORDER_SEND",
    "TICKET":6549871,
    "ERROR_ID":0,
    "ERROR_DESCRIPTION":"no error"
}