Skip to content

query_strategy_runs


function backtide.storage.query_strategy_runs(experiment_id, include_equity_curve=True, include_trades=True, include_orders=True)

Return every per-strategy result for a given experiment.

Parameters

experiment_id : str

The experiment id (as stored in the experiments table).

include_equity_curve : bool, default=True
Include each strategy's per-bar equity history.

include_trades : bool, default=True
Include each strategy's completed-trade history.

include_orders : bool, default=True
Include each strategy's complete order history. Set history flags to False when only metrics are needed to reduce database work and memory use.

Returns

list[RunResult]

One result entry per strategy that ran in this experiment.


See Also

Experiment

Configure and run one historical backtest experiment.

query_experiments

Return stored experiments, optionally filtered by id and/or a search string.


Example

>>> from backtide.storage import query_experiments, query_strategy_runs

>>> experiments = query_experiments()
>>> if not experiments.empty:
...     runs = query_strategy_runs(experiments.iloc[0]["id"])
...     print(runs)

[RunResult(id="5df21d9580bd45f9", strategy="BuyAndHold", n_bars=11514, n_trades=2, is_benchmark=false, error=None)]