Backtesting
HyperionX runs historical strategy backtests through Validator. A backtest replays loaded historical candles using the selected strategy, data-series settings, fill model, commission model, leverage, and position-sizing behavior.
Backtesting is research, not a forecast of live performance. Historical candles cannot reproduce queue position, market impact, disconnected sessions, or every intrabar price path.
The active release-candidate source now registers product-owned default commission, optimizer, fitness, and money-management modules and includes the related sources in the installer manifest. The exact clean, signed installer has not yet passed installation and workflow smoke validation. Until it does, treat Validator and Optimizer as unavailable on a fresh public installation. Do not copy modules from an untrusted source as a workaround. See Install, Update, And Uninstall.
Before You Start
You need:
- A strategy that compiles in Code Lab.
- An instrument and data series.
- Historical candles for every Validator item you plan to run.
- A strategy assigned to each item, or one strategy applied to all items.
- A commission selection when the packaged modules are available.
- Valid strategy parameters and quantity or money-management settings.
Validator does not download or infer every missing input when you press Run. An item without loaded candles prevents the relevant test from starting.
Run A Historical Backtest
- Open Validator.
- Select Add instrument for one test, or Add test set for a saved group.
- Choose the instrument, connection, bar type, interval, and historical date range.
- Load historical candles for every item.
- Select a compiled strategy.
- Apply that strategy to the current item, or use Apply all when the same strategy and preset should be used across the set.
- Review the strategy parameters, commission, backtest leverage, historical fill model, and continuous-futures merge setting where applicable.
- Select Run.
- Review the aggregate result and each instrument result.
- Export the summary or save the strategy/test preset when you need to repeat the setup.
Validator can cancel an active run. Completed Validator results are also saved to the performance-results store.
Historical Fill Models
HyperionX currently provides two candle-based historical fill models:
| Fill model | Behavior |
|---|---|
| OHLC stop-first | Uses candle OHLC information and resolves an ambiguous stop/target candle in favor of the stop. |
| OHLC virtual path | Uses a virtual path through the candle to determine the assumed order of intrabar prices. |
Both are approximations. If a candle touches a stop and target, the selected model can materially change the result. Record the selected fill model when comparing runs.
Slippage And Liquidity
Ordinary Validator and Optimizer runs do not provide a configurable slippage model in the current release. Do not describe a historical result as slippage-adjusted unless your strategy or a separate research workflow explicitly applies that cost.
Commission is modeled through the selected commission module when that module is available. Commission is not the same as slippage, spread, queue position, partial fills, or market impact.
Strategies that depend on tick-level ordering, very small targets, or high turnover need additional playback and simulation testing.
Review The Result
Review more than net profit:
- Total trades and average trade.
- Gross profit and gross loss.
- Max drawdown.
- Profit factor.
- Sharpe and Sortino values where available.
- Win rate and long/short contribution.
- Consecutive wins and losses.
- Commission.
- Instrument contribution in a portfolio test.
- Ambiguous fills and the selected historical fill model.
Use Find Improvements as a research aid, not as proof that a strategy is robust. Re-run changed settings and keep out-of-sample dates separate from the data used to choose parameters.
Move Beyond Historical Testing
HyperionX separates these stages:
| Stage | What it checks |
|---|---|
| Historical backtest | Strategy behavior against stored candles under the selected historical assumptions. |
| Playback | Real-time-style strategy behavior while historical activity is replayed. |
| Simulation | Current platform and connection behavior without intentionally routing to a live account. |
| Small live test | Real execution behavior with tightly controlled risk. |
For playback or simulation, explicitly select the intended LocalPaper or other non-live account. Playback does not change the selected account. The current release-candidate build rejects Broker and Server Paper order mutations while Playback is active, but that guard is not a substitute for selecting and verifying LocalPaper.
Save Enough Context
The saved performance record is useful for browsing and reopening results, but it is not currently a complete reproducibility package. Keep a separate record of strategy parameters, starting capital, commission configuration, and any assumptions that are not preserved by the results database.
See Performance Database for the exact persistence limitations.