Skip to content

TRADE_HISTORY Command

Get a list of closed trades

Help 
{
    "MSG":"HELP",
    "COMMAND":"TRADE_HISTORY",
    "DESCRIPTION":"Get a list of closed orders",
    "MANDATORY_TAGS":[
        "FROM_DATE (String)",
        "TO_DATE (String)",
        "MODE (String)"
    ],
    "OPTIONAL_TAGS":[null],
    "ERROR_ID":0,
    "ERROR_DESCRIPTION":"The operation completed successfully"
}

MODE values:

  • POSITIONS
  • DEALS
  • ORDERS
  • ORDERS_DEALS

Example

Single Line command (necessary for MTsocketAPI):

{"MSG":"TRADE_HISTORY", "FROM_DATE":"2022/09/19 07:00:00", "TO_DATE": "2022/09/19 13:35:00","MODE":"POSITIONS"}

Same command in Beauty Format:

{
    "MSG":"TRADE_HISTORY",
    "FROM_DATE":"2022/09/19 07:00:00",
    "TO_DATE":"2022/09/19 13:35:00",
    "MODE":"POSITIONS"
}

MTsocketAPI reply:

{
  "MSG": "TRADE_HISTORY",
  "MODE": "POSITIONS",
  "POSITIONS": [
    {
      "OPEN_TIME": "2025.01.15 20:51:41.117",
      "SYMBOL": "EURUSD",
      "TICKET": 3236195358,
      "TYPE": "BUY",
      "VOLUME": 0.02,
      "PRICE_OPEN": 1.02913,
      "MAGIC": 0,
      "COMMENT": null,
      "CLOSE_TIME": "2025.01.15 20:54:24.928",
      "PRICE_CLOSE": 1.029205,
      "PROFIT": 0.15,
      "COMMISSION": 0,
      "SWAP": 0,
      "SL": 0,
      "TP": 0,
      "CHANGE": 0.01
    }
  ],
  "ERROR_ID": 0,
  "ERROR_DESCRIPTION": "The operation completed successfully"
}