Candlestick-Pattern-Scanner

KO | EN

gitlite — search

#javascript #react #ai #golang #machine-learning #rust #docker #macos #awesome #cli #kubernetes #vue #security #openai

Candlestick-Pattern-Scanner

(★ 118)

CandlestickPatternScanner is a utility class that helps Expert Advisors and trading bots to efficiently detect reversal

Candlestick-Pattern-Scanner 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Candlestick-Pattern-Scanner
The Candlestick Pattern Scanner is a utility class that helps Expert Advisors and trading bots to efficiently detect reversal candle patterns. These special patterns can be used as potential indications of trend-reversals, especially in conjunction with other events, indicators and signals.

<h2>1. Intro</h2>
Motivation Many online traders preffer to automate their trading strategies, but they don't have good, reliable scripts, to help confidently detect candle-stick pattern like stars, engulfings and consolidation. I struggled with this alot and decided to make things easier for myself and other traders, by programming in and sharing this MQL5 Metatrader script.
Problem One of the biggest problems in trading with EAs (Expert Advisors/ trading bots) is finding reliable signals that can actually be used in code. There are many scripts in the marketplace that do visually idendify patterns on the chart, by drawing visual aids. But very few (if any) convert these candle-patterns into usable, code-ready objects, that can easily be incorporated as part of the internal making of an algorithm. Too many scripts only show patterns on the graphs, but that is useless for the trading bots, since they need objects from which to read data, to base decisions on.
Solution My script identifies reversal patterns, it converts them into objects stored in an array. There is an option to customize how rigid the pattern-detection should be, to mark out only the strongest reversal signals. Visual square markings can be customized as well (color, style and thickness), for bullish and bearish patterns. I even optimized memory usage, by making sure to delete older patterns, or broken ones. Reversal patterns have many attributes and my code can read, change, and distinguish reversals based on their properties - to decide which trading actions to undertake.

## 2. Table of Contents
1. [Intro](#1-intro)
2. [Table of Contents](#2-table-of-contents)
3. [Project Description](#3-project-description)
   - [Definition & Terminology](#definition--terminology)
4. [How to Install and Run the Project](#4-how-to-install-and-run-the-project)
5. [How to Tweak and Configure the Scanner Script Functionality](#5-how-to-tweak-and-configure-the-scanner-script-functionality)
6. [How to Use the Project](#6-how-to-use-the-project)
7. [Credits](#7-credits)
8. [License](#8-license)

<h2>3. Project Description</h2>
 
 <a target="_blank" rel="noopener noreferrer" href="/img/candle-patterns-red-green-v1.PNG">
 <img src="/img/candle-patterns-red-green-v1.PNG" alt="Green Red Bullish Bearish Reversals">
 </a>

<h3>Definition & Terminology</h3>
 What are bearish reversal patterns? [RED] Bearish consolidations & engulfings, along with evening stars are price bar signals, indicating that the price will be going downwards. It will continue dropping or reverse & fall, after an uptrend.
 What are bullish reversal patterns? [GREEN] Bullish patterns (consolidations, engulfings and morning stars) are a signal of rising prices. The price will be moving upwards, or reverse from downtrend to uptrend.

Based on priority, my scripts detects the following candle-patterns:
<ul>
 <li>Consolidations are the strongest reversal signals since they hold the highest amount of trading information, spaning across 3 to 6 bars.</li>
 <li>Engulfings represent highly trustworthy reversal patterns, particularly if their position & timing are right. They appear more frequently in mid-to-higher timeframes.</li>
 <li>Stars & Hammers, are pretty reliable signals in high timeframes, if used togheter with other measurements and trading signals.</li>
</ul>

<table cellspacing="5" border="0">
 <tr>
 <td>
 
 <a target="_blank" rel="noopener noreferrer" href="/img/candle-patterns-magenta-gold-v1.PNG">
 <img src="/img/candle-patterns-magenta-gold-v1.PNG" alt="Candlestick Patterns Magenta and Gold">
 </a>
 
 Bearish patterns are encircled in a magenta color, and they indicate a downward move in price. As shown in the graph above, this is actually true. 
 Bullish patterns appear in gold-yellow; bullish means that price will move upwards, and this appears to be the case here as well. 
 </td>
 </tr>
</table>

<table cellspacing="5" border="0">
 <tr>
 <td>
 
 <a target="_blank" rel="noopener noreferrer" href="/img/candle-patterns-deeppink-aqua-v1.PNG">
 <img src="/img/candle-patterns-deeppink-aqua-v1.PNG" alt="Candlestick Patterns Deep Pink and Aqua">
 </a>
 
 Similar example, but since color is a completely customizable feature, I chose an alternative color scheme this time. 
 Deep pink means bearish signal. The price will drop, or reverse from uptrend to downtrend. 
 Aqua blue indicates a bullish reversal. Rising prices are expected, as the two bullish engulfings prove in this graphic. 
 </td>
 </tr>
</table>

<h2>4. How to Install and Run the Project</h2>
Step 1. Include the class file in your trading robot. The file-path (inside the "#include" preprocessor directive) might change depending on your folder structure or where you place the file:

```MQL5
#include <__SimonG\MS\CandlestickPatternScanner\CandlestickPatternScanner.mqh>
```
Step 2. Declare two global or local variables of type "CandlestickPatternScanner" and "CandlestickPattern". 
Note that "CandlestickPatternScanner" detects, stores and retrieves objects of type "CandlestickPattern", which are captured and saved at pointer location, as defined below:

```MQL5
CandlestickPatternScanner * cps;
CandlestickPattern * patternDetected;
```

Step 3. Initialize the CandlestickPatternScanner object. The best place for this is inside the OnInit() function.

```MQL5
int OnInit(){
 cps = new CandlestickPatternScanner (Symbol(), PERIOD_CURRENT, 15, true);
 cps.adjust_Settings_Graphic_BearishReversals (clrDeepPink, STYLE_SOLID, 4);
 cps.adjust_Settings_Graphic_BullishReversals (clrAqua, STYLE_SOLID, 4);
 cps.adjust_Settings_Chart_Subwindow (0, 0);
 cps.adjust_Settings_Engulfings (0.75, 5);
 cps.adjust_Settings_Stars (0.25, 40, 0.35);
 cps.setDoDrawCandlePatternRect (true);
}
```
 
Step 4. Activate the CandlestickPatternScanner (cps), and set it up so that it extracts the most recent price reversal pattern (captured at pointer variable CandlestickPattern (patternDetected)).
This function detects the most recent reversal and stores it inside an array of predefined-size (see previous step). Even though we write this piece of code inside OnTick(), because of the internal structure of CandlestickPatternScanner class, the function is only called every PERIOD_CURRENT minutes. (5min, 15min, ... 1 Day).
This periodicity can either be your current timeframe (PERIOD_CURRENT) or any other desired chart timeframe: PERIOD_M15, PERIOD_H4, PERIOD_D (check MQL5 specs).

```MQL5
void OnTick(){
   patternDetected = cps.updateAndReturn_Cps_onNewBar();
}
```

Step 5. Everything is set up. Use both objects and the most recently detected reversal pattern (bullish / bearish) in your code logic for the algorithm, to determine trading outcome.

```MQL5
bool validateOpenBuy (){
   if(patternDetected != NULL){
         if(patternDetected.getPatternType() == BULLISH_ENGULFING)
            return true;
      else if(patternDetected.getPatternType() == BULLISH_MORNING_STAR)
            return true;
   }
   return false;
}

bool validateOpenSell (){
   if(patternDetected != NULL){
         if(patternDetected.getPatternType() == BEARISH_ENGULFING)
            return true;
      else if(patternDetected.getPatternType() == BEARISH_EVENING_STAR)
            return true;
   }
   return false;
}
```

Step 6. Memory clean-up, optimization, object deletion. Clean-up is by default automatically performed by the CandlestickPatternScanner in two ways:
Patterns in the internal storage-array are deleted once broken. Secondly, since the array has a LIFO structure (Last-In-First-Out), whenever a new object is detected and stored, the last one (oldest one) is popped out and deleted. Closing/stopping the EA-bot eliminates the CandlestickPatternScanner objects, which removes the array and the CandlestickPattern objects inside of it:

```MQL5
void OnDeinit (const int reason){
   delete cps;
   delete patternDetected;
}
```

<h2>5. How to Tweak and Configure the Scanner Script Functionality</h2>
This is how you can configure your scripts.

<h2>6. How to Use the Project</h2>
Now that we know how to install and run the project, let's see how we can use it. I shall provide a bunch of ideas for trading robots:

| Pattern | RSI | Trading Outcome |
| :--- | :--- | ---: |
| Bullish Pattern | Overbought (RSI<30) | Open BUY trade. |
| Bearish Pattern | Oversold (RSI>30) | Open SELL trade. |

<h2>7. Credits</h2>
I can't credit anyone directly, but this section seems appropriate because I owe special thanks to so many course & content creators, chanels, youtubers.
1. MQL4 Programming. Visit https://www.youtube.com/channel/UCIuhfiM34b2P8qv_HX_uwug/featured 
2. ForexBoat Team. Check out https://www.udemy.com/course/learn-mql4/ 
These guys create amazing content and I have learned so much from them!

<h2>8. License</h2>
Feel free to use this project for yourself. Or to edit it, use bits of it. Do not commercialize it!
My Candlestick-Pattern-Scanner project is licensed under the GNU AGPLv3 license. Check out the licence link to better understand what you can and cannot do with this code.

Candlestick-Pattern-Scanner

Candlestick-Pattern-Scanner 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Candlestick-Pattern-Scanner

Candlestick-Pattern-Scanner 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README