Variables Intégrées

Whale‑E expose des variables intégrées en lecture seule pour les métriques de performance, les informations de position et les données de bougies.

Métriques de Performance

VariableDescription
initial_capitalLe capital de départ du backtest.
Constante sur tout le backtest (définie à l’initialisation).
equityLa valeur actuelle du portefeuille, calculée comme initial_capital + netprofit + openprofit.
Recalculée lorsque le moteur réévalue les positions ouvertes au prix de marché, à la clôture de chaque bougie et après chaque exécution d’ordre ou liquidation.
netprofitLe profit net réalisé de la stratégie.
Mis à jour à chaque clôture de position ou liquidation. Sa valeur finale correspond à la somme des gains et pertes réalisés.
grossprofitLa somme des gains réalisés sur les positions clôturées gagnantes.
Mis à jour à chaque clôture de position ou liquidation avec gain réalisé.
grosslossLa somme des pertes réalisées sur les positions clôturées perdantes, exprimée en valeur positive.
Mise à jour à chaque clôture de position ou liquidation avec perte réalisée.
openprofitLe profit ou la perte non réalisé sur les positions ouvertes.
Recalculé lorsque le moteur réévalue les positions ouvertes au prix de marché, à la clôture de chaque bougie et après chaque exécution d’ordre ou liquidation.
openprofit_percentLe profit ou la perte non réalisé sur les positions ouvertes, en pourcentage de l’équité réalisée.
Recalculé lorsque le moteur réévalue les positions ouvertes au prix de marché, à la clôture de chaque bougie et après chaque exécution d’ordre ou liquidation.
grossprofit_percentLa somme des gains réalisés sur les positions clôturées gagnantes, exprimée en pourcentage du capital initial.
Mis à jour à chaque clôture de position ou liquidation avec gain réalisé.
grossloss_percentLa somme des pertes réalisées sur les positions clôturées perdantes, exprimée en pourcentage du capital initial.
Mise à jour à chaque clôture de position ou liquidation avec perte réalisée.
avg_winning_tradeLe profit moyen des transactions gagnantes.
Mis à jour lors de chaque clôture ou liquidation gagnante.
avg_losing_tradeLa perte moyenne des transactions perdantes.
Mise à jour lors de chaque clôture ou liquidation perdante.
avg_winning_trade_percentLe profit moyen des transactions gagnantes, exprimé en pourcentage de la valeur d’entrée de la position clôturée, frais inclus.
Recalculé à chaque clôture enregistrée (y compris clôture partielle et liquidation).
avg_losing_trade_percentLa perte moyenne des transactions perdantes, exprimée en pourcentage de la valeur d’entrée de la position clôturée, frais inclus.
Recalculée à chaque clôture enregistrée (y compris clôture partielle et liquidation).
avg_tradeLe profit ou la perte moyen de toutes les transactions.
Recalculé à chaque clôture enregistrée (y compris clôture partielle et liquidation).
avg_trade_percentLe profit ou la perte moyen de toutes les transactions, exprimé en pourcentage de la valeur d’entrée de la position clôturée, frais inclus.
Recalculé à chaque clôture enregistrée (y compris clôture partielle et liquidation).
closedtradesLe nombre total de transactions clôturées.
Incrémenté à chaque clôture enregistrée (y compris clôture partielle et liquidation).
opentradesLe nombre actuel de transactions ouvertes.
Mis à jour à chaque entrée, clôture ou liquidation.
max_drawdownLe drawdown maximum de la stratégie.
Mis à jour à chaque bougie (extrêmes high/low et clôture) et lors des mises à jour de PnL réalisé.
max_drawdown_percentLe drawdown maximum de la stratégie, en pourcentage à partir d’une valeur d’équité maximale.
Mis à jour à chaque bougie (extrêmes high/low et clôture) et lors des mises à jour de PnL réalisé.
max_runupLe run-up maximum de la stratégie.
Mis à jour à chaque bougie à partir des extrêmes intrabougie.
max_runup_percentLe run-up maximum de la stratégie, en pourcentage à partir d’une valeur d’équité minimale.
Mis à jour à chaque bougie à partir des extrêmes intrabougie.

Contexte du Marché

Ces variables décrivent la grille en cours d’exécution.

VariableDescription
tickerSymbole principal du backtest (ex. BTCUSDT, ETHUSDT).
Constante pendant toute l’exécution du backtest.
tickeridIdentifiant complet exchange:symbol utilisé pour le backtest (ex. BINANCE:BTCUSDT).
Constante pendant toute l’exécution du backtest.

Informations sur la Position

Ces variables décrivent la position actuelle.

VariableDescription
position_avg_priceLe prix d’entrée moyen de la position actuelle.
Recalculé lors des ouvertures et renforcements de position, conservé lors d’un allègement partiel, et remis à NaN lorsque la position devient plate.
margin_liquidation_priceLe prix de liquidation estimé pour la position actuelle.
Recalculé lors des changements de taille de position ou de marge, et remis à NaN lorsque la position devient plate ou quand la marge est désactivée.

Données de Bougie

Ces variables sont des séries temporelles qui exposent les données OHLCV de la bougie actuelle.

Note sur les séries et l’indexation

  • L’accès direct, par exemple close, est équivalent à close[0].
  • L’indexation entre crochets donne accès à l’historique : close[1] renvoie la bougie précédente, close[2] l’avant-dernière, etc.
  • Si l’indice demandé dépasse l’historique disponible, la valeur renvoyée est NaN.
VariableDescription
openLe prix d’ouverture de la bougie actuelle.
Mise à jour à chaque nouvelle bougie clôturée du timeframe principal.
highLe prix le plus haut de la bougie actuelle.
Mise à jour à chaque nouvelle bougie clôturée du timeframe principal.
lowLe prix le plus bas de la bougie actuelle.
Mise à jour à chaque nouvelle bougie clôturée du timeframe principal.
closeLe prix de clôture de la bougie actuelle.
Mise à jour à chaque nouvelle bougie clôturée du timeframe principal.
volumeLe volume de la bougie actuelle.
Mise à jour à chaque nouvelle bougie clôturée du timeframe principal.
hl2La moyenne des prix haut et bas de la bougie actuelle.
Mise à jour à chaque nouvelle bougie clôturée du timeframe principal.
hlc3La moyenne des prix haut, bas et de clôture de la bougie actuelle.
Mise à jour à chaque nouvelle bougie clôturée du timeframe principal.
ohlc4La moyenne des prix d’ouverture, haut, bas et de clôture de la bougie actuelle.
Mise à jour à chaque nouvelle bougie clôturée du timeframe principal.
hlcc4La moyenne des prix haut, bas et deux fois la clôture de la bougie actuelle.
Mise à jour à chaque nouvelle bougie clôturée du timeframe principal.