Skip to content

TRACK_TRADE_EVENTS Command

This command must be sent to TCP/77. Once received, MTsocketAPI will initiate order events streaming over the data port, which defaults to TCP/78:

Help 
{
    "MSG":"HELP",
    "COMMAND":"TRACK_TRADE_EVENTS",
    "DESCRIPTION":"Receive trade events in the configured DATA port",
    "MANDATORY_TAGS":[null],
    "OPTIONAL_TAGS":["ENABLED (Boolean)"]
}

Example

Single Line command (necessary for MTsocketAPI) give us the actual state:

{"MSG":"TRACK_TRADE_EVENTS"}

Same command in Beauty Format:

{
    "MSG":"TRACK_TRADE_EVENTS"
}
MTsocketAPI reply:

{
    "MSG":"TRACK_TRADE_EVENTS",
    "ENABLED":false,
    "ERROR_ID":0,
    "ERROR_DESCRIPTION":"The operation completed successfully"
}

If we want to start receiving trade events:

{
    "MSG":"TRACK_TRADE_EVENTS",
    "ENABLED":true
}

Now we can connect to default TCP 78 port to see the order events when a new order is open/closed/modified...

$ telnet localhost 78
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
{"MSG":"TRACK_TRADE_EVENTS","TRADE_TRANSACTION":{"DEAL":0,"DEAL_TYPE":"DEAL_TYPE_BUY","ORDER":2293361403,"ORDER_STATE":"ORDER_STATE_STARTED","ORDER_TYPE":"ORDER_TYPE_BUY","POSITION":0,"POSITION_BY":0,"PRICE":0.00000000,"PRICE_SL":0.00000000,"PRICE_TP":0.00000000,"PRICE_TRIGGER":0.00000000,"SYMBOL":"SPX500_m","TIME_EXPIRATION":"1970.01.01 00:00:00","TIME_TYPE":"ORDER_TIME_GTC","TYPE":"TRADE_TRANSACTION_ORDER_ADD","VOLUME":0.03000000},"DEMO":"MTsocketAPI running in DEMO mode (www.mtsocketapi.com)"}
{"MSG":"TRACK_TRADE_EVENTS","TRADE_TRANSACTION":{"DEAL":0,"DEAL_TYPE":"DEAL_TYPE_BUY","ORDER":2293361403,"ORDER_STATE":"ORDER_STATE_REQUEST_ADD","ORDER_TYPE":"ORDER_TYPE_BUY","POSITION":0,"POSITION_BY":0,"PRICE":0.00000000,"PRICE_SL":0.00000000,"PRICE_TP":0.00000000,"PRICE_TRIGGER":0.00000000,"SYMBOL":"SPX500_m","TIME_EXPIRATION":"1970.01.01 00:00:00","TIME_TYPE":"ORDER_TIME_GTC","TYPE":"TRADE_TRANSACTION_ORDER_UPDATE","VOLUME":0.03000000},"DEMO":"MTsocketAPI running in DEMO mode (www.mtsocketapi.com)"}
{"MSG":"TRACK_TRADE_EVENTS","TRADE_TRANSACTION":{"DEAL":0,"DEAL_TYPE":"DEAL_TYPE_BUY","ORDER":0,"ORDER_STATE":"ORDER_STATE_STARTED","ORDER_TYPE":"ORDER_TYPE_BUY","POSITION":0,"POSITION_BY":0,"PRICE":0.00000000,"PRICE_SL":0.00000000,"PRICE_TP":0.00000000,"PRICE_TRIGGER":0.00000000,"SYMBOL":null,"TIME_EXPIRATION":"1970.01.01 00:00:00","TIME_TYPE":"ORDER_TIME_GTC","TYPE":"TRADE_TRANSACTION_REQUEST","VOLUME":0.00000000},"TRADE_REQUEST":{"ACTION":"TRADE_ACTION_DEAL","COMMENT":null,"DEVIATION":0,"EXPIRATION":"1970.01.01 00:00:00","MAGIC":0,"ORDER":2293361403,"POSITION":0,"POSITION_BY":0,"PRICE":0.00000000,"SL":0.00000000,"STOPLIMIT":0.00000000,"SYMBOL":"SPX500_m","TP":0.00000000,"TYPE":"ORDER_TYPE_BUY","TYPE_FILLING":"ORDER_FILLING_FOK","TYPE_TIME":"ORDER_TIME_GTC","VOLUME":0.03000000},"TRADE_RESULT":{"ASK":0.00000000,"BID":0.00000000,"COMMENT":null,"DEAL":0,"ORDER":2293361403,"PRICE":0.00000000,"REQUEST_ID":3967966209,"RETCODE":10008,"RETCODE_EXTERNAL":0,"VOLUME":0.00000000},"DEMO":"MTsocketAPI running in DEMO mode (www.mtsocketapi.com)"}
{"MSG":"TRACK_TRADE_EVENTS","TRADE_TRANSACTION":{"DEAL":0,"DEAL_TYPE":"DEAL_TYPE_BUY","ORDER":2293361403,"ORDER_STATE":"ORDER_STATE_PLACED","ORDER_TYPE":"ORDER_TYPE_BUY","POSITION":0,"POSITION_BY":0,"PRICE":0.00000000,"PRICE_SL":0.00000000,"PRICE_TP":0.00000000,"PRICE_TRIGGER":0.00000000,"SYMBOL":"SPX500_m","TIME_EXPIRATION":"1970.01.01 00:00:00","TIME_TYPE":"ORDER_TIME_GTC","TYPE":"TRADE_TRANSACTION_ORDER_UPDATE","VOLUME":0.03000000},"DEMO":"MTsocketAPI running in DEMO mode (www.mtsocketapi.com)"}
{"MSG":"TRACK_TRADE_EVENTS","TRADE_TRANSACTION":{"DEAL":0,"DEAL_TYPE":"DEAL_TYPE_BUY","ORDER":0,"ORDER_STATE":"ORDER_STATE_STARTED","ORDER_TYPE":"ORDER_TYPE_BUY","POSITION":0,"POSITION_BY":0,"PRICE":0.00000000,"PRICE_SL":0.00000000,"PRICE_TP":0.00000000,"PRICE_TRIGGER":0.00000000,"SYMBOL":null,"TIME_EXPIRATION":"1970.01.01 00:00:00","TIME_TYPE":"ORDER_TIME_GTC","TYPE":"TRADE_TRANSACTION_REQUEST","VOLUME":0.00000000},"TRADE_REQUEST":{"ACTION":"TRADE_ACTION_DEAL","COMMENT":null,"DEVIATION":0,"EXPIRATION":"1970.01.01 00:00:00","MAGIC":0,"ORDER":0,"POSITION":0,"POSITION_BY":0,"PRICE":0.00000000,"SL":0.00000000,"STOPLIMIT":0.00000000,"SYMBOL":"SPX500_m","TP":0.00000000,"TYPE":"ORDER_TYPE_BUY","TYPE_FILLING":"ORDER_FILLING_FOK","TYPE_TIME":"ORDER_TIME_GTC","VOLUME":0.03000000},"TRADE_RESULT":{"ASK":0.00000000,"BID":0.00000000,"COMMENT":null,"DEAL":0,"ORDER":2293361403,"PRICE":0.00000000,"REQUEST_ID":3967966209,"RETCODE":10009,"RETCODE_EXTERNAL":0,"VOLUME":0.03000000},"DEMO":"MTsocketAPI running in DEMO mode (www.mtsocketapi.com)"}
{"MSG":"TRACK_TRADE_EVENTS","TRADE_TRANSACTION":{"DEAL":2282203801,"DEAL_TYPE":"DEAL_TYPE_BUY","ORDER":2293361403,"ORDER_STATE":"ORDER_STATE_STARTED","ORDER_TYPE":"ORDER_TYPE_BUY","POSITION":2293361403,"POSITION_BY":0,"PRICE":4459.30000000,"PRICE_SL":0.00000000,"PRICE_TP":0.00000000,"PRICE_TRIGGER":0.00000000,"SYMBOL":"SPX500_m","TIME_EXPIRATION":"1970.01.01 00:00:00","TIME_TYPE":"ORDER_TIME_GTC","TYPE":"TRADE_TRANSACTION_DEAL_ADD","VOLUME":0.03000000},"DEMO":"MTsocketAPI running in DEMO mode (www.mtsocketapi.com)"}
{"MSG":"TRACK_TRADE_EVENTS","TRADE_TRANSACTION":{"DEAL":0,"DEAL_TYPE":"DEAL_TYPE_BUY","ORDER":2293361403,"ORDER_STATE":"ORDER_STATE_FILLED","ORDER_TYPE":"ORDER_TYPE_BUY","POSITION":2293361403,"POSITION_BY":0,"PRICE":0.00000000,"PRICE_SL":0.00000000,"PRICE_TP":0.00000000,"PRICE_TRIGGER":0.00000000,"SYMBOL":"SPX500_m","TIME_EXPIRATION":"1970.01.01 00:00:00","TIME_TYPE":"ORDER_TIME_GTC","TYPE":"TRADE_TRANSACTION_ORDER_DELETE","VOLUME":0.00000000},"DEMO":"MTsocketAPI running in DEMO mode (www.mtsocketapi.com)"}
{"MSG":"TRACK_TRADE_EVENTS","TRADE_TRANSACTION":{"DEAL":0,"DEAL_TYPE":"DEAL_TYPE_BUY","ORDER":2293361403,"ORDER_STATE":"ORDER_STATE_FILLED","ORDER_TYPE":"ORDER_TYPE_BUY","POSITION":2293361403,"POSITION_BY":0,"PRICE":0.00000000,"PRICE_SL":0.00000000,"PRICE_TP":0.00000000,"PRICE_TRIGGER":0.00000000,"SYMBOL":"SPX500_m","TIME_EXPIRATION":"1970.01.01 00:00:00","TIME_TYPE":"ORDER_TIME_GTC","TYPE":"TRADE_TRANSACTION_HISTORY_ADD","VOLUME":0.00000000},"DEMO":"MTsocketAPI running in DEMO mode (www.mtsocketapi.com)"}
Important

You must request order events data using the port TCP/77 and MTsocketAPI will stream order events on port TCP/78.

Tip

You can connect multiple clients to TCP/78 port and all of them will receive the order events data.