Skip to content

Vcp


class backtide.strategies.Vcp(lookback=60, contractions=3)

Volatility Contraction Pattern breakout strategy.

Detects a Volatility Contraction Pattern: a series of progressively tighter price consolidations with declining volume. When both price range and volume have contracted sufficiently, the strategy enters long on a breakout above the consolidation ceiling. Useful for swing trading setups where decreasing supply precedes a sharp move.

Parameters

lookback : int, default=60

Number of bars to detect the contraction pattern.

contractions : int, default=3
Minimum number of contracting ranges required.

Attributes

name : str

Human-readable strategy name.

is_multi_asset : bool
Whether this is a multi-asset strategy.


See Also

DoubleTop

Chart-pattern breakout triggered by a double-top formation.

RiskAverse

Low-volatility breakout strategy for risk-conscious investors.

TurtleTrading

Classic channel-breakout trend-following system with ATR-based position sizing.


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.