CrossChart_Controller_EA

MQL5 EA Requirement Structure for Multi-Chart Control with Auto-Pause, Detailed Monitoring, Google Sheet Authorization, and Auto Close on Resume

1. EA Name

• Example: "CrossChart_Controller_EA"

2. EA Overview

• Description: This EA includes a central dashboard on one chart that enables users to control EAs on multiple charts, with added authorization via Google Sheets. To use the EA, users must enter their user ID and broker server name for authentication, verified through the Google Sheet.

3. Google Sheet Authorization

• Purpose: To control access to the EA by verifying user credentials against a Google Sheet.
• Requirements:
  • Google Sheet Setup: A Google Sheet containing authorized user details (e.g., User ID, Broker Server Name).
  • External Access: Enable access to external websites in MetaTrader 5 to connect with Google Sheets.
• Authorization Process:
  • User Input: User inputs their User ID and Broker Server Name upon setup.
  • Google Sheet Verification: The EA checks these credentials against the Google Sheet to confirm authorization.
  • Access Control: If credentials match, the EA enables functionality; otherwise, access is denied, and the EA displays a warning message.

4. Inter-Chart Communication Methods

• Global Variables for Cross-Chart Control:
  • Use global variables to manage settings across multiple charts. For example, "EA_Pause_Chart1" can be set to pause the EA on Chart 1 when specific conditions are met.
• Event-Based Communication (Optional):
  • Trigger real-time updates using custom events for immediate actions like pausing/resuming EAs on other charts.

5. Dashboard Control Features

• Auto-Pause Functionality:

  1. Automatic Pause Based on Stop Value or Percentage:
     • Condition: Automatically pause the EA on a specific chart when it reaches a defined stop value or percentage of account equity.
     • Implementation: Track each chart’s profit/loss and compare it to user-defined stop conditions stored in global variables (e.g., "Stop_Value_Chart2" ).
  2. Manual Pause Button for Each Chart EA:
     • Functionality: Provide a manual pause button on the dashboard to pause or resume each chart’s EA.
     • Implementation: Dashboard sets a global variable (e.g., "EA_Pause_Chart2" ) that the target chart reads to pause/resume its trading logic.

• Auto Close on Resume:

  • Description: Automatically closes all buy/sell orders for a specific pair when the EA is resumed after an auto-pause or manual pause, based on the pair’s total profit/loss meeting a defined target.
  • Settings:
    1. Target Profit/Loss Value per Pair: Set a specific profit/loss target for each pair to trigger the auto-close function.
    2. Enable/Disable Option: Option to enable/disable this feature for specific pairs.
  • Implementation: The EA checks the total profit/loss of each pair when resuming, and if it meets the specified target, all buy/sell orders for that pair are closed.

• Real-Time Parameter Adjustments Across Charts:

  • Adjustable Parameters: Lot Size, TP, and SL for each chart or all charts.
  • Implementation: Dashboard updates global variables (e.g., "Lot_Size_Chart3" ) that each chart reads to apply updated settings.

• Detailed Chart-Specific Information Display:

  1. Statistics per Chart:
     • Chart Identifier: A unique identifier or number for each chart for quick reference.
     • Current Trade Pair Symbol: Displays the symbol of the currently active trading pair on each chart.
     • Buy Lots: Total BUY lot size on each chart, specifically for the current trade pair.
     • Sell Lots: Total SELL lot size on each chart, specifically for the current trade pair.
     • Total Lot Size: Combined BUY and SELL lot sizes for the current trade pair on each chart.
     • Profit/Loss: Real-time profit or loss for the current trade pair on each chart.
     • EA Status: Indicates if the EA on each chart is active, paused (manually or automatically), or awaiting resumption.
  2. Manual Pause Button:
     • Each chart’s information section on the dashboard includes a Pause/Resume button, displayed next to its detailed statistics. This button allows the user to manually pause or resume the EA on each specific chart.

6. Execution and Error Handling

• Global Variable Checks: Each chart instance periodically checks global variables for updated dashboard commands.
• Google Sheet Access Error Handling: Display a warning message if authorization fails or external access encounters issues.
• Error Logging: Log actions and errors to ensure smooth functionality across charts.

7. Settings Menu Configurations

• Authorization Settings:
  • User ID and Broker Server Name fields to input user credentials.
• Auto-Pause Settings:
  • Stop Value and Stop Percentage inputs for each chart to trigger auto-pause if conditions are met.
  • Manual pause button for each chart EA in the settings menu and on the dashboard.
• Auto Close on Resume Settings:
  • Target profit/loss per pair for auto close.
  • Enable/Disable toggle for each pair.
• Adjustable Lot Size, TP, SL, and Martingale Settings for each chart instance.

8. Dashboard Display Customization

• Real-Time Updates: Dashboard refreshes to show updated metrics and EA status for each chart.
• Detailed Metrics per Chart:
  • Chart Identifier, Current Trade Pair Symbol, Buy Lots, Sell Lots, Total Lot Size, Profit/Loss, and EA Status.
  • Manual Pause/Resume button next to each chart’s information.
• Color Coding: Optional color coding for active/paused status, positive/negative profit, and other indicators.