MyTradingHistory

An easy-to-use library that provides developers with straightforward access to key trading statistics for their MQL5 EAs.

Available methods from the library:

Account Data & Profit:

• GetAccountBalance() : Returns the current account balance.
• GetProfit() : Returns the net profit from all trades.
• GetDeposit() : Returns the total amount of deposits.
• GetWithdrawal() : Returns the total amount of withdrawals.

Trading Analysis:

• GetProfitTrades() : Returns the number of profitable trades.
• GetLossTrades() : Returns the number of losing trades.
• GetTotalTrades() : Returns the total number of executed trades.
• GetShortTrades() : Returns the number of short trades.
• GetLongTrades() : Returns the number of long trades.
• GetWinLossRatio() : Returns the ratio of winning to losing trades.
• GetAverageProfitTrade() : Returns the average profit per profitable trade.
• GetAverageLossTrade() : Returns the average loss per losing trade.
• GetROI() : Calculates the return on investment.
• GetLargestProfitTrade() : Returns the largest profit from a single trade.
• GetLargestLossTrade() : Returns the largest loss from a single trade.
• GetShortTradesWon() : Returns the percentage of successful short trades.
• GetLongTradesWon() : Returns the percentage of successful long trades.

Trade Profit Array:

• GetTradeProfitArray(double &outputArray[]) : Returns an array of profits for each individual trade, enabling detailed trade result analysis.

Sample code below:

// Import the external MyTradingHistory.ex5 module
#import "MyTradingHistory.ex5"
   void UpdateValues(void);                         // Updates the trading data from the MyTradingHistory library. EXECUTE THIS EVERY TIME YOU WANT TO UPDATE THE VALUES, e.g. after closing a trade or before retreiving the value for the first time.
   void GetTradeProfitArray(double &outputArray[]); // Retrieves an array of profits from closed trades
   double GetAccountBalance(void);                 // Returns the current account balance
   double GetProfit(void);                         // Returns the net profit
   double GetDeposit(void);                        // Returns the total deposit amount
   double GetWithdrawal(void);                     // Returns the total withdrawal amount
   int GetProfitTrades(void);                      // Returns the number of profitable trades
   int GetLossTrades(void);                        // Returns the number of loss trades
   int GetTotalTrades(void);                       // Returns the total number of trades
   int GetShortTrades(void);                       // Returns the number of short trades
   int GetLongTrades(void);                        // Returns the number of long trades
   double GetWinLossRatio(void);                   // Returns the win-to-loss ratio
   double GetAverageProfitTrade(void);             // Returns the average profit per trade
   double GetAverageLossTrade(void);               // Returns the average loss per trade
   double GetROI(void);                            // Returns the return on investment (ROI)
   double GetLargestProfitTrade(void);             // Returns the largest profit from a single trade
   double GetLargestLossTrade(void);               // Returns the largest loss from a single trade
   double GetShortTradesWon(void);                 // Returns the percentage of short trades won
   double GetLongTradesWon(void);                  // Returns the percentage of long trades won
#import

// OnInit is executed when the script starts
int OnInit()
{
   // Update internal data from the imported module
   UpdateValues();

   // Prepare a string to display account and trade summary
   string output = "Account Balance: " + DoubleToString(GetAccountBalance(), 2) + "\n" +
                   "Net Profit: " + DoubleToString(GetProfit(), 2) + "\n" +
                   "Deposit: " + DoubleToString(GetDeposit(), 2) + "\n" +
                   "Withdrawal: " + DoubleToString(GetWithdrawal(), 2) + "\n" +
                   "Profit Trades: " + IntegerToString(GetProfitTrades()) + "\n" +
                   "Loss Trades: " + IntegerToString(GetLossTrades()) + "\n" +
                   "Total Trades: " + IntegerToString(GetTotalTrades()) + "\n" +
                   "Short Trades: " + IntegerToString(GetShortTrades()) + "\n" +
                   "Long Trades: " + IntegerToString(GetLongTrades()) + "\n" +
                   "Win/Loss Ratio: " + DoubleToString(GetWinLossRatio(), 2) + "\n" +
                   "Average Profit per Trade: " + DoubleToString(GetAverageProfitTrade(), 2) + "\n" +
                   "Average Loss per Trade: " + DoubleToString(GetAverageLossTrade(), 2) + "\n" +
                   "ROI: " + DoubleToString(GetROI(), 2) + "\n" +
                   "Largest Profit Trade: " + DoubleToString(GetLargestProfitTrade(), 2) + "\n" +
                   "Largest Loss Trade: " + DoubleToString(GetLargestLossTrade(), 2) + "\n" +
                   "Short Trades Won: " + DoubleToString(GetShortTradesWon(), 2) + "%\n" +
                   "Long Trades Won: " + DoubleToString(GetLongTradesWon(), 2) + "%\n";

   // Add trade profit array data to the output
   output += "Trade Profit Array (First 5 Trades): ";
   double tradeProfitArray[]; // Declare an array to store trade profit data
   GetTradeProfitArray(tradeProfitArray); // Fetch trade profit data

   // Loop through the first 5 trades and append their profit values to the output
   for (int i = 0; i < MathMin(5, ArraySize(tradeProfitArray)); i++)
   {
      output += DoubleToString(tradeProfitArray[i], 2) + ", ";
   }

   // Append the last trade's profit value
   output += "...\nLast Closed Trade: ";
   int size = ArraySize(tradeProfitArray); // Get the size of the trade profit array
   if (size > 0)
      output += DoubleToString(tradeProfitArray[size - 1], 2); // Append the last trade's profit
   else
      output += "No trades available."; // Handle the case where no trades exist

   // Display the summary as a comment on the chart
   Comment(output);

   // Signal successful initialization
   return(INIT_SUCCEEDED);
}

Your feedback is welcome and appreciated. Please share your thoughts and questions before&after purchase.