Discussing the article: "Price Action Analysis Toolkit Development (Part 81): Adding Persistent Historical Bookmarks to an MQL5 Navigator"

 

Check out the new article: Price Action Analysis Toolkit Development (Part 81): Adding Persistent Historical Bookmarks to an MQL5 Navigator.

We introduce a persistent bookmark layer for the MetaTrader 5 History Navigator. Bookmarks capture a chart's symbol, timeframe, and historical position with a name and notes, write them to a CSV file, and reload them later without manual date entry. The implementation integrates bookmark management into the current navigation engine, enabling quick creation, selection, navigation, and deletion for efficient historical study.

In the previous instalment of this series, we developed a History Navigator for MetaTrader 5 that allowed a chart to be positioned at a specified historical date and time. The navigator provided a structured alternative to manually scrolling through large amounts of historical data.

However, date-based navigation remains temporary. Once a useful historical location has been identified, the navigator does not retain that location for future analysis. Returning to the same point therefore requires the date and time to be entered again.

This limitation is most noticeable during historical market analysis, where the same price-action events may be revisited repeatedly.  A trader may want to preserve a significant market structure, a historical setup, an unusual price movement, or an important support or resistance area and return to it later without having to remember its exact timestamp. The natural extension is to introduce persistent historical bookmarks.

A bookmark associates a historical chart position with a user-defined name and optional notes. In addition to the timestamp, the bookmark records the corresponding symbol and timeframe, allowing the navigator to reconstruct the original chart context when the bookmark is selected.

The bookmarks are persisted to a CSV file, allowing them to remain available beyond the lifetime of the navigator. They can therefore be reused after the navigator is removed and reattached or after the MetaTrader 5 terminal is restarted.

In this article, we extend the History Navigator by adding a bookmark storage layer and integrating it into the interface. The implementation covers creation, persistence, loading, selection, navigation, and deletion, while preserving the application's modular structure.

This transforms the navigator from a date-based positioning tool into a reusable historical reference system.

The GIF below demonstrates navigation to a specific historical date using the History Navigator developed in the previous instalment. Although this provides a convenient way to locate historical price action, the selected location is not retained as a reusable reference.

Author: Christian Benjamin