TRADE_HISTORY
Description
Provides history of CLOSED trades.
Important
All JSON commands you send to MetaSocket should be in a single line format similar to the examples below. Additionally, example replies in this page are presented in a "beautified" format for presentation purposes. Actual replies are always returned in a single line.
Example
{"MSG": "TRADE_HISTORY","FROM_DATE": "2025/08/14 00: 00: 00","TO_DATE": "2025/08/14 23: 59: 59","MODE": "POSITIONS"}
Reply
{
"MSG": "TRADE_HISTORY",
"MODE": "POSITIONS",
"POSITIONS": [
{
"OPEN_TIME": "2025.08.14 06:05:28.528",
"SYMBOL": "EURUSD",
"TICKET": 41899381,
"TYPE": "BUY",
"VOLUME": 0.2,
"PRICE_OPEN": 1.17026,
"MAGIC": 0,
"COMMENT": "1675F0F9-9111-4AB6-9AC5-3D02726",
"CLOSE_TIME": "2025.08.14 08:30:05.173",
"PRICE_CLOSE": 1.16976,
"PROFIT": -10,
"COMMISSION": 0,
"SWAP": 0,
"SL": 0,
"TP": 0,
"CHANGE": 0
},
{
"OPEN_TIME": "2025.08.14 08:32:35.355",
"SYMBOL": "EURUSD",
"TICKET": 41929132,
"TYPE": "SELL",
"VOLUME": 0.6,
"PRICE_OPEN": 1.16966,
"MAGIC": 0,
"COMMENT": "332ECC13-E587-486A-A619-B874E59",
"CLOSE_TIME": "2025.08.14 08:42:14.138",
"PRICE_CLOSE": 1.17016,
"PROFIT": -30,
"COMMISSION": 0,
"SWAP": 0,
"SL": 0,
"TP": 0,
"CHANGE": 0
},
{
"OPEN_TIME": "2025.08.14 08:43:28.008",
"SYMBOL": "EURUSD",
"TICKET": 41931856,
"TYPE": "SELL",
"VOLUME": 1.4,
"PRICE_OPEN": 1.17002,
"MAGIC": 0,
"COMMENT": "5AABC826-E925-44F4-B171-DA22A01",
"CLOSE_TIME": "2025.08.14 09:12:22.802",
"PRICE_CLOSE": 1.17052,
"PROFIT": -70,
"COMMISSION": 0,
"SWAP": 0,
"SL": 0,
"TP": 0,
"CHANGE": 0
},
{
"OPEN_TIME": "2025.08.14 12:13:55.635",
"SYMBOL": "EURUSD",
"TICKET": 41980035,
"TYPE": "SELL",
"VOLUME": 3.1,
"PRICE_OPEN": 1.16832,
"MAGIC": 0,
"COMMENT": "370949B6-9363-469B-AD1B-9F900EC",
"CLOSE_TIME": "2025.08.14 13:21:17.546",
"PRICE_CLOSE": 1.16882,
"PROFIT": -155,
"COMMISSION": 0,
"SWAP": 0,
"SL": 0,
"TP": 0,
"CHANGE": 0
},
{
"OPEN_TIME": "2025.08.14 13:22:30.750",
"SYMBOL": "EURUSD",
"TICKET": 41991766,
"TYPE": "BUY",
"VOLUME": 6.3,
"PRICE_OPEN": 1.16907,
"MAGIC": 0,
"COMMENT": "E073151B-CF20-4079-8622-231D2D7",
"CLOSE_TIME": "2025.08.14 13:32:45.606",
"PRICE_CLOSE": 1.16957,
"PROFIT": 315,
"COMMISSION": 0,
"SWAP": 0,
"SL": 0,
"TP": 0,
"CHANGE": 0
}
],
"ERROR_ID": 0,
"ERROR_DESCRIPTION": "The operation completed successfully"
}