WHALE ENGINE
Documentation

Money Flow Index (mfi)

[[mfi]] est un oscillateur de momentum qui exploite le prix et le volume pour mettre en évidence les configurations de surachat et de survente.

Il compare la somme des flux positifs et la somme des flux négatifs sur une fenêtre de length bougies et retourne une valeur comprise entre zéro et cent.

La mise en œuvre suit des règles précises pour la direction, la fenêtre de calcul et la gestion des valeurs non disponibles. La source par défaut est hlc3.

Déclaration du bloc

Une stratégie peut contenir plusieurs blocs [[mfi]]. Chaque bloc produit une série numérique représentant la valeur du MFI.

Exemples

Configuration minimale

[[mfi]]
id     = "mfi"
source = "hlc3"
length = 14

Symbole et timeframe dédiés

Ce bloc calcule le MFI sur les bougies journalières de BINANCE:BTCUSDT.

[[mfi]]
id        = "mfi"
source    = "hlc3"
length    = 14
symbol    = "BINANCE:BTCUSDT"
timeframe = "D"

Recherche de la longueur optimale

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

[[mfi]]
id           = "mfi"
source       = "hlc3"
length.start = 10
length.stop  = 30
length.step  = 2

Paramètres

ParamètreDescription
id
 Texte
 Obligatoire		Nom unique pour la série MFI.
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 : "hlc3"
length
 Entier
 Obligatoire		Longueur de 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 omis, le bloc hérite du symbole de [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 MFI expose sa série numérique ainsi que ses métadonnées d’entrée.

Supposons le bloc configuré ainsi :

[[mfi]]
id     = "mfi"
source = "hlc3"
length = 14

Alors :

VariableDescription
mfi ou mfi[0]
Décimal		Valeur actuelle du MFI.
mfi[n]
Décimal		Valeur du MFI il y a n bougies.
mfi.length
Décimal		Longueur de fenêtre utilisée.
mfi.source
Texte		Nom de la série d’entrée.
mfi.symbol
Texte		Symbole utilisé.
mfi.timeframe
Texte		Unité de temps utilisée.
Préc
Lowest
Suiv
Moving Average Convergence Divergence (macd)