Sample Page Title

Introduction

Optimus Time Tracker Indicator

Welcome to the person guide for Optimus Time Tracker V1.00, a customized indicator for MetaTrader 5 (MT5) developed in MQL5. This indicator analyzes historic value knowledge to offer statistical insights into market conduct throughout completely different timeframes and buying and selling periods. It presents three evaluation modes: Weekly Excessive & Low Stats, Bullish vs. Bearish Shut, and Excessive and Low by Session. The indicator incorporates a user-friendly management panel for customizing settings and a toggle button to indicate or conceal the show.

Objective

The Optimus Time Tracker V1.00 helps merchants determine patterns in value actions by displaying:

• The frequency of weekly highs and lows occurring on particular days.
• The proportion of bullish (shut > open) versus bearish (shut < open) day by day closes.
• The distribution of day by day highs and lows throughout 4 buying and selling periods (Asian, European, Overlap, US)

Viewers

This guide is meant for:

• Newbie merchants new to MetaTrader 5 who wish to use technical indicators.
• Intermediate merchants aware of MT5 and MQL5, trying to customise and interpret the indicator’s output.
• Superior customers who want detailed configuration choices for particular buying and selling methods.

Parameters

Options and Configuration

Enter When including the indicator to a chart, you may configure the next settings within the enter dialog:

Background Transparency (BackGD_Mode):

• Choices: BackGround_On (default: Off), BackGround_Off.
• Allows or disables a lightweight grey background for the statistics tables and management panel.

Lookback Weeks (InpLookbackWeeks):

• · Default: 52 weeks.
• · Specifies the variety of weeks of historic knowledge to investigate (have to be constructive).
• · Instance: Set to 26 for a 6-month evaluation.

Server Time Offset (InpServerTimeOffset):

•  Default: 0 hours.
•  Adjusts the server time to align along with your native timezone (in hours, e.g., -3 for a 3-hour offset).

Font Dimension (InpFontSize):

• Default: 10.
• Units the font measurement for the GUI (vary: 6–20).

Session Instances:

• Outline begin and finish occasions for 4 buying and selling periods in HH:MM format (24-hour clock).
• Defaults:
• Asian Session: 00:00 to 08:00.
• European Session: 08:00 to 12:00. 
• Overlap Session: 12:00 to 16:00. 
• US Session: 16:00 to 00:00.
•  Guarantee occasions are non-overlapping and legitimate (e.g., 08:30 is legitimate, 25:00 is just not)

Evaluation Modes

The indicator presents three modes, accessible by way of navigation buttons within the management panel:

1. Weekly Excessive & Low Stats (MODE_HIGH_LOW):

• Shows the share of weeks the place every day (Sunday–Saturday) had the very best or lowest value.
• Instance: “Monday Excessive %: 20.5%” means Monday was the weekly excessive in 20.5% of analyzed weeks.
• Helpful for figuring out days with important value actions.

2. Bullish vs. Bearish Shut (MODE_BULL_BEAR):

• Exhibits the share of days with a bullish (shut > open) or bearish (shut < open) shut for every day of the week.
• Instance: “Tuesday Bullish %: 55.0%” means 55% of Tuesdays closed increased than they opened.
• Helps assess directional bias by day.

3. Excessive and Low by Session (MODE_SESSION):

• Analyzes the share of day by day highs and lows occurring in every session (Asian, European, Overlap, US) for every day.
• Shows 4 separate tables, one per session.
• Instance: “Asian Wednesday Excessive %: 30.0%” means 30% of Wednesdays had their day by day excessive through the Asian session. · Excellent for session-based buying and selling methods.

Management Panel

The management panel, situated on the proper aspect of the chart, permits real-time configuration:

Navigation Buttons:

• Excessive/Low Stats, Bull/Bear Shut, Session H/L:Change between evaluation modes.
• The energetic mode’s button is highlighted in gentle blue.

Frequent Settings:

• Weeks: Modify the lookback interval (e.g., enter 26 for 26 weeks).
• Offset: Set the server time offset (e.g., -3 for a 3-hour offset).
• Font: Change the font measurement (6–20).
• Click on Apply Settings to replace these parameters.

Customized Vary:

• Begin Date, Finish Date: Enter dates in YYYY.MM.DD format (e.g., 2024.01.01).
• Permits evaluation of a particular date vary as an alternative of the default lookback weeks.
• Click on Apply Vary to course of the customized vary.
• Word: Finish date have to be after begin date and never sooner or later.

Session Instances:

• Fields for Asian, European, Overlap, and US session begin/finish occasions (e.g., 08:00).
• Click on Apply Classes to replace session definitions.
• Guarantee occasions are legitimate and non-overlapping.

Error Label:

•  Shows error messages (e.g., “Invalid session time format”) on the backside of the panel in crimson.

Visibility Toggle Button

• Positioned within the top-right nook of the chart.
• Labeled Cover (when seen) or Present (when hidden).
• Click on to toggle the visibility of the management panel and statistics tables.
• Helpful for decluttering the chart whereas maintaining the indicator energetic.

Knowledge Persistence

• Settings (lookback weeks, offset, font measurement, session occasions, customized vary) are saved to a file named Optimus_Time_Tracker_User_settings.txt within the MT5 frequent knowledge folder (MQL5Files within the frequent listing).
• On initialization, the indicator masses saved settings, overriding default inputs if the file exists.
• Adjustments made by way of the management panel are robotically saved when making use of settings, ranges, or periods.

Utilization Directions

Beginning the Indicator

1. Add the indicator to a chart.

2. The management panel and a statistics desk (default: Excessive/Low Stats) will seem on the chart.

3. Confirm that knowledge is displayed. If not, guarantee ample historic knowledge is obtainable.

Switching Evaluation Modes

1. Within the management panel, click on one of many navigation buttons:

• · Excessive/Low Stats for weekly excessive/low percentages.
• · Bull/Bear Shut for bullish/bearish shut percentages.
• · Session H/L for session-based excessive/low distributions.

2. The statistics desk updates to mirror the chosen mode.

3. The energetic button turns gentle blue, and the chart redraws.

Adjusting Settings

1. Change Lookback Weeks, Offset, or Font Dimension:

•  Enter values within the respective fields (e.g., 26 for Weeks, 10 for Font).
•  Click on Apply Settings.
• The desk updates, and settings are saved to the settings file.

2. Set Customized Date Vary: · Enter begin and finish dates (e.g., 2024.01.01, 2024.12.31).

• Click on Apply Vary.
• The indicator processes knowledge inside the specified vary.

3. Modify Session Instances:

• Replace session begin/finish occasions (e.g., 09:00 for AsianStart).
• Click on Apply Classes.
• The session-based evaluation (MODE_SESSION) updates accordingly

Toggling Visibility

• Click on the Cover button to cover the management panel and tables.
• Click on the Present button to revive them.
• The indicator continues working within the background when hidden.

Decoding Output

• Excessive/Low Stats Desk:
• Columns: Day, Excessive %, Low %.
• Rows: Sunday to Saturday.
• Instance: “Monday Excessive %: 25.0%” means Monday was the weekly excessive in 25% of legitimate weeks.
• Bull/Bear Shut Desk: · Columns: Day, Bullish %, Bearish %.
• Rows: Sunday to Saturday. 
• Instance: “Friday Bullish %: 60.0%” means 60% of Fridays closed increased.
• Session H/L Tables: · 4 tables (Asian, European, Overlap, US), every with: · Columns: Session Title, Excessive %, Low %.
• Rows: Sunday to Saturday.
• Instance: “European Tuesday Low %: 40.0%” means 40% of Tuesdays had their low within the European session.

Finest Practices

Guarantee Adequate Knowledge:

• Obtain historic knowledge by way of MT5’s Historical past Heart (Instruments > Historical past Heart).
• Choose the image and timeframes (D1 and H1), then obtain not less than 52 weeks of knowledge.

Validate Session Instances:

• Guarantee session occasions align along with your dealer’s server time and buying and selling technique.
• Keep away from overlapping periods to forestall errors.

Use Customized Ranges Sparingly:

• Customized ranges require ample knowledge inside the specified interval.
• Revert to default lookback weeks if knowledge is lacking.

Monitor Errors:

• Verify the error label for points like “No legitimate weeks processed” or “Invalid session time format.”
• Check with the MT5 Specialists log (Ctrl+T, Specialists tab) for detailed error messages.

Check on Demo Account:

• Apply the indicator to a demo account to familiarize your self with its options earlier than utilizing it in reside buying and selling.

Troubleshooting

No Knowledge Displayed

Trigger: Inadequate historic knowledge.

Resolution:

• Open Historical past Heart (Instruments > Historical past Heart).
• Choose the image and Every day (D1) and 1 Hour (H1) timeframes.
• Obtain knowledge for not less than the lookback interval (default: 52 weeks).
• Reapply the indicator.
• examine the lookback enter discipline, then enter the look interval whether it is set to 1 on the initialization of the indicator.

Error: “No legitimate weeks processed”

Trigger: Lacking or incomplete historic knowledge for the chosen vary.

Resolution:

• Cut back the lookback weeks (e.g., from 52 to 26).
• For customized ranges, guarantee the beginning and finish dates have accessible knowledge.
• Verify the Specialists log for particular knowledge hole dates.

Error: “Invalid session time format”

Trigger: Session occasions are usually not in HH:MM format or are invalid (e.g., 25:00).

Resolution:

• Right the time format (e.g., 08:00).
• Click on Apply Classes.

 Error: “Session occasions overlap”

Trigger: Session time ranges overlap (e.g., Asian ends after European begins).

Resolution:

• Modify session occasions to be non-overlapping (e.g., Asian 00:00–08:00, European 08:00–12:00).
• Click on Apply Classes.

Indicator Not Seen

Trigger: Indicator is hidden by way of the toggle button.

Resolution:

• Click on the Present button within the top-right nook.
• If the button is lacking, take away and reapply the indicator.

Settings Not Saved

Trigger: File write error in Optimus_Time_Tracker_User_settings.txt.

Resolution:

•  Verify the Specialists log for file entry errors (e.g., permission points).
•  Guarantee MT5 has write entry to the frequent knowledge folder (MQL5Files within the MT5 knowledge listing).
• Manually delete the settings file and reapply settings to recreate it.

Limitations

Knowledge Dependency:

• Requires ample D1 (day by day) and H1 (hourly) knowledge for correct outcomes.
• Gaps in knowledge could scale back the variety of legitimate weeks processed.

Dealer Timezone:

• Session occasions are relative to the dealer’s server time, adjusted by the Server Time Offset.
• Incorrect offsets could misalign session evaluation.

Efficiency:

• Processing massive lookback intervals (e.g., > 100 weeks) or customized ranges with intensive knowledge could decelerate the indicator relying on the Power of your Machine.

Weekend Knowledge:

• Sunday and Saturday knowledge could also be restricted, as many markets are closed or have low quantity.

Assist

For points not coated on this guide:

• Verify the MT5 Specialists log for detailed error messages.
• Contact the indicator developer at devinnocentnnaji@gmail.com
• Go to the MQL5 neighborhood boards https://www.mql5.com/en/discussion board for normal MT5 assist.