Analyze (dry run)

Use --analyze to evaluate strategy workload before running a full execution.

This mode validates the strategy, builds grids, computes valid combinations, and stops before any price download or backtest run.

To run an analysis, use the following command.

whale-e strategy.toml --analyze

The output includes scheduled grids, excluded grids, and total valid combinations.

Analysis with JSON output#

You can request the same preflight as JSON.

whale-e strategy.toml --analyze --json

Pretty version:

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

JSON payload structure#

Analyze output uses _schema: "whale-e.analyze.v1".

Global metrics include total_grids, scheduled_grids, excluded_grids, total_valid_combinations, total_id_space, and pruning_ratio.

The payload also includes grids[] with per-grid fields: grid_number, symbol, timeframe, valid_combinations, id_space, pruning_ratio, pre_scan_ms, and scheduled.

The formula is pruning_ratio = (id_space - valid_combinations) / id_space, with 0 when id_space = 0.

Example (truncated):

{
  "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 cannot be combined with --export-pinescript.
• In --analyze --json mode, --json-objective-limit and all --json-include-* options are rejected.
• In --analyze --json mode, --json-pretty is the only allowed JSON sub-option.