Logo
    User Avatar

    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"
    }