WHALE ENGINE
Documentation

Money Flow Index (mfi)

[[mfi]] (Money Flow Index) met en relation l’évolution de source et le volume échangé sur une fenêtre de length valeurs. Chaque bougie contribue par un flux égal à source × volume. Ce flux est classé comme positif lorsque source augmente par rapport à sa valeur précédente, et comme négatif lorsqu’elle diminue.

Les flux positifs et négatifs sont cumulés séparément, puis comparés pour former la série MFI. Lorsque source reste positive et que la valeur est définie, la sortie suit l’échelle conventionnelle de 0 à 100 : une valeur élevée indique une domination des flux positifs, une valeur faible une domination des flux négatifs, et une valeur proche du milieu des flux d’ampleur comparable.

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.volume_source
Texte		Nom de la série de volume utilisée.
mfi.symbol
Texte		Symbole utilisé.
mfi.timeframe
Texte		Unité de temps utilisée.

Notes

  • Si le flux négatif cumulé sur la fenêtre vaut zéro, la valeur du MFI n’est pas disponible (NaN).
  • Si source change de signe, les contributions peuvent elles aussi changer de signe et la sortie peut quitter l’intervalle conventionnel de 0 à 100.
Préc
Lowest Bars (lowestbars)
Suiv
Median (median)