WHALE ENGINE
Documentation

Highest

[[highest]] renvoie, à chaque bougie, la valeur la plus élevée observée sur la fenêtre des length dernières barres pour la série choisie. Vous l’utilisez pour suivre une borne haute récente, définir une résistance mobile, détecter un breakout ou comparer le niveau courant à son extrême le plus haut sur une période donnée.

Contrairement à une moyenne, Highest ne lisse pas le marché et ne cherche pas à résumer le prix par une valeur centrale. Il conserve le maximum de la fenêtre en cours, puis ne change que lorsqu’un plus haut plus récent apparaît ou lorsque l’ancien maximum sort de la fenêtre. Vous obtenez ainsi une référence simple et stable, qui décrit la limite supérieure du mouvement récent plutôt qu’une tendance moyenne.

Le résultat dépend entièrement de la série d’entrée. Appliqué à high, le bloc suit le plus haut des bougies récentes. Appliqué à close ou à la sortie d’un autre indicateur, il suit le maximum récent de cette série. Cela en fait un outil utile pour construire un canal, formuler une condition de franchissement ou réutiliser un extrême récent dans d’autres blocs de la stratégie.

Déclaration du bloc

Une stratégie peut contenir plusieurs blocs [[highest]]. Chaque bloc produit une série numérique : la valeur du maximum glissant.

Exemples

Configuration minimale

Ce bloc utilise la source implicite "high" et suit donc le plus haut observé sur les 20 dernières barres.

[[highest]]
id     = "highest"
length = 20

Source personnalisée et recherche de la longueur optimale

Ce bloc explore une plage de valeurs pour length à partir des clôtures afin d’identifier la longueur la plus performante.

[[highest]]
id           = "highest"
source       = "close"
length.start = 10
length.stop  = 30

Paramètres

ParamètreDescription
id
 Texte
 Obligatoire		Identifiant unique de la série produite.
source
 Texte
 ou Tableau
 Optionnel		Série d’entrée utilisée pour le calcul.
Formats acceptés : source = "hl2" ou source = ["close", "hl2"].
Chaque valeur peut être soit une source de prix standard (open, close, high, low, hl2, hlc3, ohlc4, hlcc4, volume), soit l’id d’un autre indicateur.
Valeur par défaut : "high"
length
 Entier
 Obligatoire		Taille de la fenêtre, doit être ≥ 1.

Usage :
• Fixe : length = valeur
• Grille :
 – length.start = valeur_minimale
 – length.stop = valeur_maximale
 – length.step = valeur (optionnel, par défaut 1)
symbol
 Texte ou Tableau
 Optionnel		Symbole(s) de marché utilisé(s) lorsque source ne contient que des prix standard (open, close, high, low, hl2, hlc3, ohlc4, hlcc4, volume).
Si source mélange des prix standard et des identifiants d’indicateurs, symbol s’applique uniquement aux combinaisons basées sur des prix standard.
Si source ne contient que des identifiants d’indicateurs, symbol est ignoré.
Si symbol est omis, le bloc utilise le symbole principal défini dans [backtest].
Pour le format, les tableaux et l’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

Utilisez directement les identifiants ci-dessous dans vos expressions. Le bloc highest expose une série numérique et ses paramètres (length, source, symbol, timeframe).

Supposons le bloc configuré ainsi :

[[highest]]
id     = "highest"
length = 20

Alors :

VariableDescription
highest ou highest[0]
Décimal		Maximum glissant courant (première valeur valide après length - 1 bougies).
highest[n]
Décimal		Valeur du maximum il y a n bougies (highest[1] pour la bougie précédente).
highest.length
Décimal		Longueur effectivement utilisée (utile en optimisation).
highest.source
Texte		Source réelle (high, close, autre indicateur).
highest.symbol
Texte		Symbole employé par ce bloc.
highest.timeframe
Texte		Timeframe appliqué à l’indicateur.
Préc
Wait
Suiv
Ichimoku Kijun-sen