RocRotation

class backtide.strategies.RocRotation(period=12, top_k=5, rebalance_interval=20)

Multi-asset portfolio rotation ranked by Rate of Change.

Periodically ranks all assets by their Rate of Change (momentum) over a given window and rotates the portfolio into the top K performers. A classic relative-momentum rotation approach used to capture the strongest trends across a basket of instruments.

Parameters	period : int, default=12 ROC look-back period for ranking. top_k : int, default=5 Number of top-ranked assets to hold. rebalance_interval : int, default=20 Number of bars between rebalancing.
Attributes	name : str Human-readable strategy name. is_multi_asset : bool Whether this is a multi-asset strategy.

Methods

description	Short explanation of what the strategy does.
evaluate	Evaluate the strategy and return orders.
required_indicators	Indicators that must be computed up-front for this strategy.

method description()

Short explanation of what the strategy does.

Returns

str

The description.

method evaluate(data, portfolio, state, indicators=None)

Evaluate the strategy and return orders.

Parameters

data : dict[str, numpy.ndarray | pandas.DataFrame | polars.DataFrame]

Keys are the experiment's symbols and values are the historical OHLCV data available up to the current bar. For example, data["AAPL"]["close"] selects AAPL's visible close-price history.

portfolio : backtide.backtest.Portfolio

Current portfolio holdings (cash, positions and open orders). For example, portfolio.positions.get("AAPL", 0.0) returns the current signed quantity, while portfolio.orders contains pending orders.

state : backtide.backtest.State

Current simulation state. For example, use state.is_warmup to suppress orders during warmup and state.datetime to read the current bar's timezone-aware timestamp.

indicators : dict[str, dict[str, numpy.ndarray | pandas.DataFrame | polars.DataFrame]] | None

The first keys are the indicator names. The second keys are the experiment's symbols. The values are the pre-computed indicator histories available up to the current bar. For example, indicators["SMA_20"]["AAPL"] selects AAPL's visible 20-bar SMA history. None is permitted when no indicators were selected.

Returns

list[Order]

Orders to place this tick.

method required_indicators()

Indicators that must be computed up-front for this strategy.

Returns a list of indicator instances, already parameterized with this strategy's current settings, that the engine will auto-include before the backtest starts.

Returns

list[BaseIndicator]

The required indicator instances.