Analyse (dry run)

Le mode --analyze sert à évaluer la charge d’une stratégie avant exécution complète.

Ce mode valide la stratégie, construit les grilles, calcule le nombre de combinaisons valides et s’arrête avant le téléchargement des prix et avant tout backtest.

Pour lancer une analyse, exécutez la commande suivante.

whale-e strategie.toml --analyze

La sortie résume notamment le nombre de grilles planifiées, le nombre de grilles exclues et le total des combinaisons valides.

Analyse avec sortie JSON#

Vous pouvez demander la même analyse au format JSON.

whale-e strategie.toml --analyze --json

Version formatée :

whale-e strategie.toml --analyze --json --json-pretty

Structure du payload JSON#

Le payload d’analyse utilise le schéma _schema: "whale-e.analyze.v1".

Il contient les métriques globales suivantes : total_grids, scheduled_grids, excluded_grids, total_valid_combinations, total_id_space et pruning_ratio.

Il contient aussi grids[] avec les détails par grille : grid_number, symbol, timeframe, valid_combinations, id_space, pruning_ratio, pre_scan_ms et scheduled.

La formule est pruning_ratio = (id_space - valid_combinations) / id_space, avec la valeur 0 lorsque id_space = 0.

Exemple (tronqué) :

{
  "success": true,
  "_schema": "whale-e.analyze.v1",
  "mode": "analyze",
  "total_grids": 12,
  "scheduled_grids": 10,
  "excluded_grids": 2,
  "total_valid_combinations": 150000,
  "total_id_space": 300000,
  "pruning_ratio": 0.5,
  "grids": [
    {
      "grid_number": 0,
      "symbol": "BINANCE:BTCUSDT",
      "timeframe": "60",
      "valid_combinations": 12000,
      "id_space": 24000,
      "pruning_ratio": 0.5,
      "pre_scan_ms": 12,
      "scheduled": true
    }
  ]
}

Notes#

• --analyze ne peut pas être combiné avec --export-pinescript.
• En mode --analyze --json, --json-objective-limit et toutes les options --json-include-* sont rejetées.
• En mode --analyze --json, --json-pretty est la seule sous-option JSON autorisée.