WHALE ENGINE
Documentation

Donchian Channels

[[donchian]] délimite une plage de prix à partir des extrêmes récents. La bande supérieure correspond au plus haut observé sur les length dernières bougies, et la bande inférieure au plus bas observé sur cette même fenêtre. Vous l’utilisez pour repérer des cassures, encadrer le prix dans sa zone de variation récente ou comparer plusieurs longueurs de canal dans une recherche par grille.

Quand le prix franchit l’une des deux bandes, cela indique qu’il sort de sa plage récente par le haut ou par le bas. Un canal qui s’élargit traduit des extrêmes plus éloignés et donc un marché plus agité. Un canal plus resserré indique au contraire une plage de variation plus étroite. Le canal de Donchian ne cherche pas à lisser le prix : il met directement en évidence les bornes hautes et basses du marché sur la période étudié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_lo.low_source
Texte		Noms des sources d’entrée utilisées (High/Low).
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
Trailing
Suiv
Trend