WHALE ENGINE
Documentation

Donchian Channels

[[donchian]] produit deux bornes qui décrivent la plage de prix récente. Sur chaque bougie, la bande supérieure correspond au plus haut des prix high sur les length dernières bougies, tandis que la bande inférieure correspond au plus bas des prix low sur la même fenêtre. La bougie courante fait partie du calcul : un nouvel extrême déplace immédiatement la bande concernée.

Le canal s’élargit lorsque ses deux bornes s’éloignent et se resserre lorsqu’elles se rapprochent. Une bande reste plate tant que son extrême ne change pas, même si le prix continue d’évoluer à l’intérieur de la plage. Contrairement à une moyenne mobile, le canal de Donchian ne lisse pas une série : il conserve directement ses limites haute et basse sur la période observée.

Déclaration du bloc

Une stratégie peut contenir plusieurs blocs [[donchian]]. Chaque bloc génère deux séries numériques distinctes : la bande supérieure et la bande inférieure du canal de Donchian. Ces deux séries sont identifiées à l’aide des champs upper_id et lower_id.

Le bloc [[donchian]] ne possède pas de paramètre source car le canal de Donchian est toujours calculé à partir des prix high et low des bougies.

Exemples

Configuration minimale

Ce bloc calcule les deux bandes du canal de Donchian avec la longueur par défaut 20.

[[donchian]]
upper_id = "donchian_up"
lower_id = "donchian_lo"

Configuration fixe personnalisée

Ce bloc utilise une valeur personnalisée pour length.

[[donchian]]
upper_id = "donchian_up"
lower_id = "donchian_lo"
length   = 22

Recherche de la longueur optimale

Ce bloc explore une plage de valeurs pour length afin d’identifier la longueur de canal la plus performante.

[[donchian]]
upper_id     = "donchian_up"
lower_id     = "donchian_lo"
length.start = 15
length.stop  = 25

Marché et timeframe dédiés

Ce bloc calcule le canal de Donchian sur BINANCE:BTCUSDT et le timeframe 60. Comme length est omis, le bloc utilise la longueur par défaut 20.

[[donchian]]
upper_id  = "donchian_up"
lower_id  = "donchian_lo"
symbol    = "BINANCE:BTCUSDT"
timeframe = "60"

Paramètres

ParamètreDescription
upper_id
 Texte
 Obligatoire		Identifiant de la bande supérieure.
lower_id
 Texte
 Obligatoire		Identifiant de la bande inférieure.
symbol
 Texte
 ou Tableau
 Optionnel		Symbole(s) de marché depuis lequel ce bloc lit ses bougies (high, low). Si symbol est omis, le bloc utilise le symbole principal défini dans [backtest]. Pour le format des symboles, l’utilisation de tableaux et les règles d’alignement, voir Exchanges, Symboles et Timeframes.
timeframe
 Texte
 ou Tableau
 Optionnel		Timeframe sur lequel cet indicateur est calculé.
Si timeframe est omis, le calcul se fait sur le timeframe principal de la grille défini dans [backtest].
Pour les formats acceptés et les règles d’alignement entre timeframes, voir Exchanges, Symboles et Timeframes.
length
 Entier
 Optionnel		Fenêtre de calcul, doit être ≥ 1.
Valeur par défaut : 20.

Usage :
• Fixe : length = valeur
• Grille :
 – length.start = valeur_minimale
 – length.stop = valeur_maximale
 – length.step = valeur (optionnel, par défaut 1)

Variables disponibles

Vous pouvez utiliser directement les identifiants ci‑dessous dans vos expressions. Le bloc canal de Donchian expose deux séries numériques (bande supérieure et bande inférieure), ainsi que leurs paramètres et leur contexte de calcul.

Supposons le bloc configuré ainsi :

[[donchian]]
upper_id = "donchian_up"
lower_id = "donchian_lo"

Alors :

VariableDescription
donchian_up ou
donchian_up[0]
Décimal		Valeur actuelle de la bande supérieure.
donchian_up[n]
Décimal		Valeur de la bande supérieure il y a n bougies.
donchian_lo ou
donchian_lo[0]
Décimal		Valeur actuelle de la bande inférieure.
donchian_lo[n]
Décimal		Valeur de la bande inférieure il y a n bougies.
donchian_up.length
Décimal		Longueur Donchian utilisée (exposée sur l’identifiant supérieur).
donchian_up.high_source
donchian_up.low_source
donchian_lo.high_source
donchian_lo.low_source
Texte		Noms des sources d’entrée utilisées (high et low) sur chaque sortie.
donchian_up.symbol
donchian_lo.symbol
Texte		Symbole de marché utilisé.
donchian_up.timeframe
donchian_lo.timeframe
Texte		Timeframe utilisé.

Notes

  • Les variables numériques acceptent l’arithmétique, les comparaisons et les opérateurs logiques.
  • Les variables textuelles sont destinées aux comparaisons d’égalité/inégalité.
Préc
Demarker Indicator (dm)
Suiv
Trend