Skip to content

TurtleTrading


class backtide.strategies.TurtleTrading(entry_period=20, exit_period=10, atr_period=20)

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

A classic trend-following system inspired by the Turtle Traders. Buys on a breakout above the highest high of the last N bars and sells on a breakdown below the lowest low of the last M bars. Uses ATR-based position sizing to normalise risk across instruments. Useful for systematic trend-following with built-in risk management.

Parameters

entry_period : int, default=20

Number of bars for the entry breakout (highest high).

exit_period : int, default=10
Number of bars for the exit breakdown (lowest low).

atr_period : int, default=20
ATR period for position sizing.

Attributes

name : str

Human-readable strategy name.

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


See Also

BuyAndHold

Passive baseline that buys once and holds indefinitely.

Momentum

Trend-following strategy driven by short-term price momentum.

RiskAverse

Low-volatility breakout strategy for risk-conscious investors.


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.