Outil
Candlestick Patterns
market.candlestick_patterns
Entrées
Aucune entrée typée.
Sorties
Un flux d’événements par bougie des figures de chandeliers détectées, chacune portant le nom de la figure (engulfing, hammer, doji, dark-cloud, morning star, …) et son biais haussier ou baissier. Acheminez-le vers interpretor.candlestick_pattern pour transformer une figure nommée en signal tradable.
Analyse les dernières bougies et vous indique quand une figure de retournement classique se dessine — engulfings, hammers, dojis, dark-cloud covers, morning/evening stars et davantage. Chaque figure détectée est rapportée avec son nom et sa direction afin que vous puissiez contrer ou suivre le retournement qu’elle suggère.
Fonctionnement
Il lit l’ouverture, le plus haut, le plus bas et la clôture de chaque bougie et mesure la taille du corps, la longueur des mèches et les écarts par rapport à un corps moyen glissant, puis confronte ces proportions à une bibliothèque de figures de chandeliers nommées. Une figure n’est validée que si la géométrie de la bougie passe ses tests de ratio et que la tendance préalable (jugée sur trend_lookback bougies via trend_method) pointe dans le bon sens pour un retournement.
Modes
Juge la tendance préalable par la variation nette de prix (momentum) sur trend_lookback bougies — si le prix est en hausse sur la fenêtre le contexte est haussier, donc seules les figures de retournement baissier sont validées, et inversement.
Quand l’utiliser: Le contrôle de contexte le plus rapide et réactif ; utile quand vous voulez la direction récente du swing plutôt qu’une moyenne lissée pour filtrer les figures.
Juge la tendance préalable en comparant le prix à une moyenne mobile simple sur trend_lookback bougies — un prix au-dessus d’une moyenne ascendante signifie un contexte haussier, un prix en dessous d’une moyenne descendante signifie un contexte baissier.
Quand l’utiliser: Le contrôle de contexte plus lissé et stable ; à préférer quand vous voulez moins de faux signaux dans le filtre de tendance, afin que les figures ne soient acceptées que dans un mouvement clairement établi.
Configuration
Ratio maximal corps/amplitude pour qu’une bougie compte comme un doji (un corps quasi nul, ouverture et clôture presque égales). Des valeurs plus petites exigent un doji plus plat et plus académique ; 0.1 signifie que le corps peut atteindre au plus 10 % de l’amplitude totale.
Le ratio corps/corps-moyen en dessous duquel une bougie est traitée comme ayant un corps « court », utilisé par la logique des stars et des harami. Des valeurs plus basses exigent un corps plus petit pour être qualifié de court.
Le ratio corps/corps-moyen au-dessus duquel une bougie est traitée comme ayant un corps « long », utilisé pour confirmer la bougie forte dans les figures engulfing, marubozu et star. Des valeurs plus élevées exigent un corps plus dominant.
Ratio minimal de la longue mèche inférieure par rapport au corps pour un hammer (ou de la mèche supérieure pour un shooting star). Des valeurs plus grandes exigent une mèche de rejet plus marquée avant que la figure ne soit validée.
Mèche supérieure maximale autorisée pour un hammer, exprimée par rapport au corps, afin qu’un vrai hammer ait peu ou pas de mèche en haut. Des valeurs plus petites imposent un hammer plus net avec la clôture près du plus haut.
De combien le corps de la bougie engulfing doit être plus grand que le corps qu’il avale, sous forme de ratio. 1.0 signifie qu’il doit simplement couvrir le corps précédent ; des valeurs au-dessus de 1.0 exigent qu’il soit visiblement plus grand.
Pour un dark-cloud cover (et son miroir haussier, le piercing line), la fraction minimale de retour de la deuxième bougie dans le corps de la première. 0.5 est l’exigence classique du « au-delà du point médian ».
Pour les figures morning star et evening star, jusqu’où la troisième bougie doit clôturer dans le corps de la première pour confirmer le retournement. Des valeurs plus élevées exigent une reprise ou un rejet plus décisif.
Tolérance, en fraction du prix, pour traiter deux niveaux comme égaux — utilisée pour détecter des ouvertures, clôtures ou mèches identiques dans les figures tweezers et harami. Des valeurs plus grandes acceptent comme « égaux » des niveaux légèrement décalés.
Écart de prix minimal entre bougies exigé par les figures dépendant d’un gap, comme les stars et les abandoned-baby. Des valeurs plus grandes imposent un gap plus net avant que ces figures ne soient validées.
Combien de bougies en arrière l’outil regarde pour déterminer la tendance préalable qu’une figure de retournement doit inverser. Des fenêtres plus longues jugent le swing plus large ; des fenêtres plus courtes réagissent à la jambe la plus récente.
Comment la tendance préalable est mesurée avant qu’une figure de retournement ne soit acceptée : « momentum » utilise la variation nette de prix sur la fenêtre, « sma » compare le prix à une moyenne mobile simple. La tendance doit s’opposer à la figure (par ex. une tendance haussière pour un engulfing baissier) pour qu’elle se déclenche.
Le type de moyenne mobile utilisé pour calculer le corps moyen glissant auquel sont comparés les tests de corps « court » et « long » (par exemple simple ou exponentielle). Il détermine la vitesse à laquelle le corps moyen s’adapte aux bougies récentes.
Se connecte à
Exemples
- Déclencheur de retournement : dans un contexte haussier (trend_method « sma »), déclenchez une vente quand un engulfing baissier se dessine avec engulfing_min_ratio à 1.1.
- Filtre de confirmation : limitez les entrées en achat aux seules bougies où un hammer haussier ou un piercing line est détecté près du support.
Erreurs courantes
- Assouplir doji_body_ratio et les ratios de corps au point que presque chaque bougie corresponde à une figure — le détecteur émet alors un bruit constant au lieu de retournements rares et significatifs.
- Oublier le filtre de tendance : un engulfing baissier dans une tendance baissière n’est qu’une continuation, pas un retournement, donc un couple trend_method / trend_lookback mal réglé supprime les figures que vous attendiez.