mql5-json

This library contains an improved version of the JAson library with better documentation and readability.

Installation

To install, simply clone this repository to your MQL5/Include directory, for MT5. For MT4, clone this repository to your MQL4/Include directory.

Examples

This library is extremely easy to use, if a bit verbose. This section contains details on how to serialize and deserialize data.

Serialization

Serializing data is as simple as filling up the JSONNode object and then calling Serialize. This example shows how you could convert an MqlTradeRequest to JSON:

#include <mql5-json/Json.mqh>

string ConverToJson(const MqlTradeRequest &request) {
   JSONNode *js = new JSONNode();
   js["action"] = (int)request.action;
   js["comment"] = request.comment;
   js["deviation"] = (long)request.deviation;
   js["expiration"] = IntegerToString(request.expiration, 10, '0');
   js["magic"] = (long)request.magic;
   js["order_id"] = (long)request.order;
   js["position_id"] = (long)request.position;
   js["opposite_position_id"] = (long)request.position_by;
   js["price"] = request.price;
   js["stop_loss"] = request.sl;
   js["stop_limit"] = request.stoplimit;
   js["symbol"] = request.symbol;
   js["take_profit"] = request.tp;
   js["type"] = (int)request.type;
   js["fill_type"] = (int)request.type_filling;
   js["expiration_type"] = (int)request.type_time;
   js["volume"] = request.volume;
      
   delete js;
   js = NULL;
   
   return js.Serialize();
}

Deserialization

Deserializing data is similarly simple. Create a JSONNode object, call the Deserialize function and then extract the data into the fields on the object you want to deserialize.

int ConverToJson(const string json, MqlTradeRequest &request) {

   JSONNode *js = new JSONNode();
   if (!js.Deserialize(json)) {
      return -1;
   }
   
   request.Action = (ENUM_TRADE_REQUEST_ACTIONS)js["action"].ToInteger();
   request.Comment = js["comment"].ToString();
   request.Expiration = (datetime)js["expiration"].ToInteger();
   request.Magic = js["magic"].ToInteger();
   request.Order = js["order"].ToInteger();
   request.Price = js["price"].ToDouble();
   request.StopLoss = js["stop_loss"].ToDouble();
   request.StopLimit = js["stop_limit"].ToDouble();
   request.Symbol = js["symbol"].ToString();
   request.TakeProfit = js["take_profit"].ToDouble();
   request.Type = (ENUM_ORDER_TYPE)js["type"].ToInteger();
   request.TypeFilling = (ENUM_ORDER_TYPE_FILLING)js["fill_type"].ToInteger();
   request.TypeTime = (ENUM_ORDER_TYPE_TIME)js["expiration_type"].ToInteger();
   request.Volume = js["volume"].ToDouble();
   
   delete js;
   js = NULL;
   
   return 0;
}

Note that in these examples, many of the types had to be casted because the operator= function is not capable of accepting enums or datetimes. This functionality will be included in a future release.