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 à chaque valorisation mark-to-market, à la clôture de chaque bougie et après chaque exécution d’ordre ou liquidation.
netprofitLe profit net de la stratégie.
Mis à jour à chaque PnL réalisé (clôture ou liquidation), puis recalculé en fin de backtest.
grossprofitLe profit brut de la stratégie.
Mis à jour lors de chaque clôture ou liquidation avec PnL réalisé positif.
grosslossLa perte brute de la stratégie.
Mise à jour lors de chaque clôture ou liquidation avec PnL réalisé négatif.
openprofitLe profit ou la perte non réalisé sur les positions ouvertes.
Recalculé à chaque valorisation mark-to-market, à 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é à chaque valorisation mark-to-market, à la clôture de chaque bougie et après chaque exécution d’ordre ou liquidation.
grossprofit_percentLe profit brut de la stratégie, en pourcentage du capital initial.
Mis à jour à chaque mise à jour de grossprofit (clôture ou liquidation gagnante).
grossloss_percentLa perte brute de la stratégie, en pourcentage du capital initial.
Mise à jour à chaque mise à jour de grossloss (clôture ou liquidation perdante).
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, en pourcentage du coût de base de la transaction.
Recalculé à chaque clôture enregistrée (y compris clôture partielle et liquidation).
avg_losing_trade_percentLa perte moyenne des transactions perdantes, en pourcentage du coût de base de la transaction.
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, en pourcentage du coût de base de la transaction.
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 donnent accès aux données OHLCV de la bougie actuelle.

Note sur les séries et l’indexation

  • Ces variables sont des séries temporelles.
  • L’accès direct (par exemple close) renvoie 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’index 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.