WHALE ENGINE
Documentation

SuperTrend

[[supertrend]] est une bande de suivi issue de l’Average True Range (ATR).

Elle alterne entre bande supérieure et inférieure selon les franchissements de prix, offrant une traîne dynamique pouvant servir de stop ou de filtre de tendance. L’indicateur utilise toujours les prix high, low et close de la bougie. Les valeurs d’ATR sont lissées par une moyenne mobile glissante (RMA) du True Range.

Déclaration du bloc

Une stratégie peut contenir plusieurs blocs [[supertrend]]. Chaque bloc produit la ligne SuperTrend et, si direction_id est défini, une série de direction (1 = tendance baissiere, -1 = tendance haussiere). Ce bloc n’a pas de clé source car il utilise toujours high, low et close.

Exemples

Configuration minimale

Ce bloc utilise length = 10 et factor = 3.0. Il expose à la fois la ligne et la direction.

[[supertrend]]
id           = "st"
direction_id = "st_dir"
# length     = 10
# factor     = 3.0

Configuration fixe personnalisée

Ce bloc utilise des valeurs personnalisées pour length et factor.

[[supertrend]]
id           = "st"
direction_id = "st_dir"
length       = 14
factor       = 2.5

Recherche de la longueur optimale

Ce bloc explore une plage de valeurs pour length, en conservant factor = 3.0.

[[supertrend]]
id           = "st"
length.start = 7
length.stop  = 21
# length     = 10
# factor     = 3.0

Recherche du facteur optimal

Ce bloc garde length = 10 et explore une plage de valeurs pour factor.

[[supertrend]]
id           = "st"
length       = 10
factor.start = 1.0
factor.stop  = 5.0
factor.step  = 0.5

Paramètres

ParamètreDescription
id
 Texte
 Obligatoire		Identifiant de la ligne SuperTrend.
direction_id
 Texte
 Optionnel		Identifiant de la direction (1 = tendance baissiere, -1 = tendance haussiere).
length
 Entier
 Optionnel		Fenêtre pour l’ATR et le lissage des bandes ; doit être >= 1 lorsqu’elle est renseignée.
Valeur par défaut : 10.

Usage :
• Fixe : length = 10
• Grille :
- length.start = valeur_minimale
- length.stop = valeur_maximale
- length.step = valeur (optionnel, par défaut 1)
factor
 Décimal
 Optionnel		Multiplicateur appliqué à l’ATR pour calculer les bandes, doit être > 0.

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

Valeur par défaut : 3.0.
symbol
 Texte
 ou Tableau
 Optionnel		Symbole(s) de marché depuis lequel ce bloc lit ses bougies (high, low, close). 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.

Variables disponibles

Vous pouvez utiliser directement les identifiants ci-dessous dans vos expressions. Le bloc SuperTrend expose la ligne et, si configurée, la direction (1 = tendance baissiere, -1 = tendance haussiere), ainsi que les paramètres (longueur, facteur), les sources d’entrée, le symbole et le timeframe.

Supposons le bloc configuré ainsi :

[[supertrend]]
id           = "st"
direction_id = "st_dir"

Alors :

VariableDescription
st ou
st[0]
Décimal		Valeur actuelle du SuperTrend.
st[n]
Décimal		Valeur du SuperTrend il y a n bougies.
st_dir ou
st_dir[0]
Décimal		Direction actuelle (1 = tendance baissiere, -1 = tendance haussiere).
st_dir[n]
Décimal		Direction il y a n bougies.
st.length
Décimal		Longueur utilisée.
st.factor
Décimal		Facteur appliqué.
st.high_src
st.low_src
st.close_src
Texte		Nom de la série d’entrée high.
Nom de la série d’entrée low.
Nom de la série d’entrée close.
st.symbol
Texte		Symbole de marché utilisé.
st.timeframe
Texte		Timeframe utilisé.

Notes

  • Les variables numériques se combinent librement (arithmétique, comparaisons, opérateurs logiques).
  • Les variables textuelles sont des chaînes destinées aux comparaisons d’égalité/inégalité uniquement.
Préc
Stochastic RSI (stoch_rsi)
Suiv
Variance