A simplified MQL5 library for integrating essential ICT (Inner Circle Trader) concepts into your trading bots and expert advisors.
---
## Integrated Concepts
| Class | Concept | Description |
|---|---|---|
| `CFvgBar` | **FVG** | Detects Fair Value Gaps (bullish & bearish) with configurable minimum size and drawing style |
| `CBosChoch` | **BOS / CHoCH** | Identifies Break of Structure and Change of Character using swing-based logic |
| `CSwingBarPure` | **Swings (Pure)** | Detects swing highs and lows using a configurable candle-based method |
| `CSwingBarZigZag` | **Swings (ZigZag)** | Detects swing highs and lows using a ZigZag indicator approach |
| `CTradingSession` | **Trading Session** | Tracks session time windows, draws ranges and exposes session high/low |
| `CRangeSession` | **Range Session** | Similar at Trading Session, but with max and min session tracking |
---
## Quick Start Examples
### FVG — Fair Value Gap
```cpp
#define DEFGLOBAL_SIMPLE
#include "..\\Global.mqh"
CFvgBar fvg;
int8_t idx_controler_d1 = INVALID_INDEX;
int OnInit()
{
const int atr_pos = ICTAtr_Create(PERIOD_CURRENT, _Symbol, 14, true);
CAtr* atr_ptr = ICTAtr_GetAtrPointer(atr_pos);
g_new_bar_manager.GetPosExecute(PERIOD_D1, idx_controler_d1);
fvg.Create(_Symbol, _Period);
fvg.SetGrapich(clrGreen, clrRed, clrGreen, clrRed, STYLE_SOLID, true, 1, true, 10, 1, STYLE_DOT);
fvg.Set(500, defined_pattern, fvg_1_vela, CreateDiffptr(MODE_DIFF_BY_ATR, _Symbol, atr_ptr, 1, 0.00));
return INIT_SUCCEEDED;
}
void OnTick()
{
const datetime curr_time = TimeCurrent();
g_new_bar_manager.Execute(curr_time);
if(CNewBarManager_IsNewBarM1(g_new_bar_manager))
{
const bool new_day = CNewBarManager_IsNewBar(g_new_bar_manager, idx_controler_d1);
ICTGen_FuncionOnBarM1(new_day, curr_time);
fvg.OnNewBar();
}
}
```
### BOS / CHoCH — Break of Structure & Change of Character
```cpp
// In OnInit()
g_bos_choch.Create(_Symbol, _Period);
g_bos_choch.SetGrapich(clr_Choch, clr_Bos, clr_Choch_2, clr_Bos_2, STYLE_DOT);
g_bos_choch.Init(2, clrRed, clrBlue, "Arial", 8, false, 30, MODE_SWING_STRICT, false, 500);
// In OnTick() — inside IsNewBar block
g_bos_choch.OnNewBar();
```
### Trading Session
```cpp
// In OnInit()
session.Create(_Symbol, _Period, 0, 0, true, true, 10, 0, 15, 0, "Trading session");
session.SetGrapichStyles(STYLE_SOLID, clrAntiqueWhite, 1, true);
session.SetExtra(clrAqua, clrAliceBlue, STYLE_SOLID, 2, draw_session_range_lines_and_rect);
// In OnTick() — inside IsNewBarM1 block
session.OnNewBarM1();
```
### Swings — Pure method
```cpp
// In OnInit()
MqlParam params[];
PureToParmas(5, 5, MODE_SWING_NO_STRICT, params);
swing.Create(_Symbol, _Period, 0, 0, true, params);
swing.SetProperties(clrBlue, clrRed, "H", "L", "Arial", 8, 10);
// In OnTick() — inside IsNewBar block
swing.OnNewBar();
```
### Swings — ZigZag method
```cpp
// In OnInit()
MqlParam params[];
ZZToParams(5, 400, false, params);
swing.Create(_Symbol, _Period, 0, 0, true, params);
swing.SetProperties(clrBlue, clrRed, "H", "L", "Arial", 8, 10);
// In OnTick() — inside IsNewBar block
swing.OnNewBar();
```
---
## Repository Structure
```
ICTLibraryEasy/
├── Src/ # Wrapper for ICT concepts imported from ICTEasyLibrary.ex5
├── Examples/ # Complete bot ict and comparative benchmarks with other libraries and code generated by LLM
└── Images/ # Repository banner
```
---
## Requirements
See the [requirements.txt](./requirements.txt) file.
---
## Installation
- Clone the git repository into shared projects via cmd.
- Contact me privately on MQL5 chats (user: nique_372) to be added as a collaborator with your MQL5 nickname (read-only access), which will make the repository automatically appear in your Shared Projects folder.
- Fork the repository.
---
## Disclaimer
**Trading involves substantial risk of loss.**
- This software is a technical tool, not financial advice
- Past performance does not guarantee future results
- You are solely responsible for your trading decisions
- Always test thoroughly before deploying with real capital
- Apply appropriate risk management at all times
The authors assume no liability for trading losses, system failures, or any damages arising from the use of this software.
---
## License
This repository uses a **dual licensing system**:
### ICT Easy Library `/Src/` + `ICTEasyLibrary.ex5`
- **License:** Apache 2.0 Modified
- **Commercial use:** Allowed in your bots
- **Selling library:** Prohibited
- **Details:** [LICENSE](./LICENSE.md)
> Only `/Src/` code can be modified. The compiled library (`ICTEasyLibrary.ex5`) cannot be reverse-engineered.
### Examples `/Examples/`
- **License:** Proprietary - Educational Use Only
- **Commercial use:** Prohibited to sell or derivatives
- **Learning:** Study and learn freely
- **Details:** [LICENSE-EXAMPLES](./LICENSE-EXAMPLES.md)
---
## Contact
- **Platform:** [MQL5 Community](https://www.mql5.com/es/users/nique_372)
- **Profile:** https://www.mql5.com/es/users/nique_372/news
---
Copyright © 2026 Nique-Leo.