MyTradingHistory
- Libraries
- Max Timur Soenmez
- Version: 1.0
- Activations: 10
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.