The open-source companion SDK to the X Tick & Volume Bar Chart indicator for MetaTrader 5.
It provides what is needed to build Expert Advisors and indicators that run directly on a tick or volume bar chart: a client library that reads the indicator's buffers, a shim that ports ordinary MT5 indicators onto the custom chart's OHLC values, 64 already-ported indicators, and three working EAs.
An EA built with this SDK inherits the settings of the chart it is attached to — there is no need to duplicate the indicator's configuration in the EA's own inputs.
The bar-building engine itself is not in this repository. It ships as a compiled indicator, purchased separately — see Getting the indicator. What lives here is the source for everything that consumes the bars it produces.
| Platform | MetaTrader 5 |
| Compiler | MetaEditor (bundled with MT5, Windows only) |
| Indicator | X Tick Chart (MQL5 Market) or Tick Chart & Volume Chart for MetaTrader 5 (az-invest.eu) — see Selecting your edition |
Download the archive from the latest release. Copy the Include,
Indicators and Experts folders into the MQL5 sub-folder of your MetaTrader data folder
(File → Open Data Folder in the terminal), merging them with what is already there, then restart
MetaTrader.
Cloning the repository instead gives you the sources without binaries; compile them in MetaEditor (F7) after copying.
The same engine is sold in two editions, and each is installed under a different indicator name.
The SDK calls it by that name through iCustom(), so the edition has to be selected at compile
time — in Include/AZ-INVEST/CustomBarConfig.mqh.
This repository ships configured for the MQL5 Market edition:
#define MQL5_MARKET_VERSIONIf you bought the indicator from az-invest.eu, comment that line out:
//#define MQL5_MARKET_VERSIONthen recompile (F7). The mapping:
| You bought | CustomBarConfig.mqh |
Indicator it looks for |
|---|---|---|
| X Tick Chart (MQL5 Market) | MQL5_MARKET_VERSION defined — the default |
Market\X Tick Chart |
| Tick Chart & Volume Chart for MetaTrader 5 (az-invest.eu) | MQL5_MARKET_VERSION commented out |
TickChart |
If the EA or a ported indicator loads but shows nothing, this is the first thing to check. A mismatch here means
iCustom()is asking for an indicator you do not have installed, which produces an empty chart rather than an error message.
CustomBarConfig.mqh and the two ready-to-trade EAs are shared with the other AZ-INVEST custom
chart SDKs, so they also carry #defines for those products (Renko, Range Bars, Seconds Chart, Line Break).
Leave them as they are: this repository contains the headers for Tick & Volume chart only, and the
VOLUMECHART_LICENSE / EA_ON_TICK_VOLUME_CHART defines are already selected.
| Path | Contents |
|---|---|
Include/AZ-INVEST/SDK/ |
Client library and helper classes |
Include/AZ-INVEST/CustomBarConfig.mqh |
Product and edition selection (#define ladder) |
Indicators/TickChart/ |
64 indicators ported to the custom chart |
Experts/ |
Three EAs — one example, two ready to trade |
Each directory mirrors its counterpart under MQL5/, which is why the install step is a straight
copy.
| Header | Purpose |
|---|---|
VolumeBarChart.mqh |
The TickChart class — handle acquisition and buffer access for the indicator. This is the one to include in an EA. |
VolumeChartIndicator.mqh |
The VolumeChartIndicator class — patches an ordinary MT5 indicator to calculate on the custom chart's OHLC values. |
CommonSettings.mqh, VolumeCustomChartSettings.mqh |
Read the settings in use on the chart, so an EA adopts them automatically. |
The class is still called
TickChart, but the header that defines it isVolumeBarChart.mqh— Volume bar charts were merged into this product, and the header name followed.TickChart.mqhis the header of the older, tick-only indicator and is not part of this SDK.
The remaining headers — settings base classes, trade functions, trading checks, trade manager, time control — are the same files as in the Median & Turbo Renko SDK, which is where they are maintained.
| EA | Demonstrates |
|---|---|
TickChart_ExampleEA.mq5 |
A minimal skeleton showing the TickChart class methods, with RSI values written to the log. |
| EA | Strategy |
|---|---|
2MA_Cross.mq5 |
Two–moving-average cross, with fixed stop loss, take profit and trading hours. |
PriceMA_Cross.mq5 |
Price/MA cross, with the same risk and session controls. |
Both read moving-average values from the indicator's buffers. If MA1/MA2 are not enabled on the indicator, these EAs receive no data and will not trade.
To run an EA in the Strategy Tester, uncomment #define SHOW_INDICATOR_INPUTS in its source and
recompile: in the tester there is no chart to inherit settings from, so the EA has to expose the
indicator's inputs itself.
The indicators in Indicators/TickChart/ all follow one pattern, applied consistently, and the
same pattern applies to any standard MT5 indicator. RSI.mq5 is the reference implementation and
carries the steps as comments.
MetaEditor compiles the sources: press F7, or run metaeditor64.exe /compile:<path> headless.
There is no macOS or Linux MQL5 compiler.
Check Selecting your edition before your first build.
This repository contains sources only. Compiled .ex5 files are not committed — continuous
integration compiles every source in Experts/ and Indicators/TickChart/ on each push and pull
request, once per edition, failing on any error or warning, and attaches the binaries to each
release. A release archive's binaries are therefore always built from exactly
the sources beside them.
| Platform | Product | Where |
|---|---|---|
| MetaTrader 5 | X Tick Chart | MQL5 Market |
| MetaTrader 5 | Tick Chart & Volume Chart for MetaTrader 5 | az-invest.eu |
Both MT5 editions are the same engine and both work with this SDK — they differ only in the indicator name, which is what Selecting your edition is about.
Released under the GNU General Public License v3. Individual indicators under
Indicators/TickChart/ are third-party sources carrying their own licences — check a file's own
header before redistributing or relicensing it.
The EAs and indicators in this repository are provided for educational and informational purposes only, and are not advice or an invitation to trade. Applying the techniques, ideas and suggestions in these files is done at the user's sole discretion and risk.