How to Get the Last Trade Profit in MQL5?

Introduction to Retrieving Last Trade Profit in MQL5

Brief Overview of MQL5 and Trading Operations

MQL5 is a high-level, object-oriented programming language designed for developing trading robots, technical indicators, scripts, and libraries for the MetaTrader 5 platform. It allows traders to automate trading strategies and perform complex market analysis. Understanding how to interact with trade history is crucial for performance evaluation and strategy refinement.

Importance of Accessing Trade Profit Information

Accessing the profit of the last trade is essential for various reasons, including:

• Performance Tracking: Evaluating the success of recent trades.
• Risk Management: Adjusting strategy parameters based on profitability.
• Reporting: Generating reports on trading activity.
• Adaptive Strategies: Modifying trading behavior dynamically.

Scope of the Article: Focusing on the Last Trade

This article will focus specifically on retrieving the profit of the last closed trade within the MetaTrader 5 environment using MQL5. We will explore different methods, provide code examples, and discuss best practices.

Understanding Trade History and Trade Properties in MQL5

Accessing Trade History using HistorySelect() and Related Functions

The HistorySelect() function is fundamental for accessing trade history in MQL5. It allows you to select a specific period of trade history for further analysis. Subsequent functions, such as HistoryDealGetTicket() and HistoryOrderGetTicket(), can then be used to retrieve details about individual trades.

Identifying the Last Closed Trade: Criteria and Methods

Identifying the last closed trade requires iterating through the trade history and filtering for closed orders (orders with a TIME_DONE property). The order with the latest TIME_DONE value is considered the last closed trade. You can retrieve the last trade regardless of whether it was a position entry/exit or a standalone closed order.

Key Trade Properties: PROFIT, COMMISSION, and SWAP

The most relevant trade properties for calculating the net profit are:

• PROFIT: The gross profit (or loss) of the trade.
• COMMISSION: The commission charged for the trade.
• SWAP: The swap (interest) charged or paid for holding the trade overnight.
  The net profit can be computed as PROFIT + COMMISSION + SWAP.

Methods to Obtain the Last Trade Profit

Method 1: Iterating Through Trade History (Example Code)

This method involves iterating through all historical deals and identifying the most recent one. This method might be more robust to corner cases but is less efficient.

Method 2: Using HistoryDealGetTicket() and HistoryDealGetInteger() (Example Code)

This approach involves iterating over deals instead of orders, and then retrieving specific deal properties using HistoryDealGetInteger(). This can provide more granular information about each part of the trade, especially useful for partial closes.

Method 3: Utilizing OrdersHistoryTotal() and OrderHistorySelect() (Example Code)

This method uses OrdersHistoryTotal() to get the total number of historical orders and then OrderHistorySelect() to select a specific order by its index. While simple, this method necessitates careful filtering to ensure you’re processing the last closed order.

Code Implementation and Examples

MQL5 Code Snippet: Function to Retrieve Last Trade Profit

double GetLastTradeProfit()
{
   datetime lastTradeTime = 0;
   double lastTradeProfit = 0.0;
   long lastTradeTicket = 0;

   HistorySelect(0, TimeCurrent());
   int totalDeals = HistoryDealsTotal();

   for (int i = 0; i < totalDeals; i++)
   {
      long dealTicket = HistoryDealGetTicket(i);
      if (dealTicket <= 0) continue;

      datetime dealTime = (datetime)HistoryDealGetInteger(dealTicket, DEAL_TIME);
      int dealType = (int)HistoryDealGetInteger(dealTicket, DEAL_TYPE);

        // We only look for deals that closed a position
        if (dealType == DEAL_TYPE_BUY || dealType == DEAL_TYPE_SELL)
        {
          datetime orderTime = (datetime)HistoryDealGetInteger(dealTicket, DEAL_TIME);

          if(orderTime > lastTradeTime) {
            lastTradeTime = orderTime;
            lastTradeTicket = dealTicket;
            lastTradeProfit = HistoryDealGetDouble(dealTicket, DEAL_PROFIT) + HistoryDealGetDouble(dealTicket, DEAL_COMMISSION) + HistoryDealGetDouble(dealTicket, DEAL_SWAP);
          }
        }
    }

   return lastTradeProfit;
}

Explanation of the Code Logic and Error Handling

1. HistorySelect(0, TimeCurrent()): Selects the entire available trade history.
2. HistoryDealsTotal(): Gets the total number of historical deals.
3. The for loop iterates through all deals. The dealType check ensures that we are only considering deals that resulted in closing the order.
4. HistoryDealGetTicket(i): Retrieves the ticket number of the i-th deal.
5. HistoryDealGetInteger(dealTicket, DEAL_TIME): Retrieves the deal’s execution time.
6. Error Handling: The if (dealTicket <= 0) continue; line includes rudimentary error handling to skip invalid deals.
7. Profit Calculation: The lastTradeProfit is calculated by summing the profit, commission, and swap values.

Illustrative Example: Displaying Profit in an Expert Advisor

void OnTick()
{
   double profit = GetLastTradeProfit();
   Comment("Last Trade Profit: ", profit);
}

This code snippet displays the profit of the last trade in the Expert Advisor’s comment section on the chart.

Best Practices, Considerations and Common Issues

Optimizing Code for Efficiency

• Limit History Selection: Avoid selecting the entire history if only recent trades are needed. Use a smaller time range with HistorySelect(startTime, endTime). However, it is often simpler to just process all deals. The code above uses all available history
• Cache Results: If the last trade profit is needed frequently, consider caching the result and updating it only when a new trade occurs, using OnTradeTransaction.

Handling Errors and Unexpected Scenarios

• Check Return Values: Always check the return values of HistorySelect(), HistoryDealGetTicket(), and HistoryDealGetInteger() for errors.
• Handle Invalid Tickets: If HistoryDealGetTicket() returns an invalid ticket number (<= 0), skip the deal.
• Account History Availability: Ensure that account history is enabled and available in the MetaTrader 5 terminal.

Considering Trade Context and Account Type

• Account Currency: The profit is always in the account currency. Consider currency conversions if necessary.
• Hedging vs. Netting: MQL5 supports both hedging and netting account types. Be aware of the account type when interpreting trade history. The above example assumes a netting account.
• Market vs. Pending Orders: Ensure that the code handles both market and pending orders correctly.

Debugging Tips for Trade History Access

• Print Statements: Use Print() statements to output intermediate values (e.g., deal ticket, time, profit) to the Experts tab in the terminal.
• Visual Inspection: Manually verify the trade history in the MetaTrader 5 terminal to confirm the accuracy of the retrieved data.
• Backtesting: Use the Strategy Tester to backtest the code and identify potential issues in trade history access.