Research Docs

cutebacktests is the public backtesting library from CuteMarkets. It packages the reusable intraday/options runtime and the opening-range profile layer that power our public research, without exposing the internal orchestration and deployment code from the private research repo.

Repository

• GitHub: cutemarkets/cutebacktests
• License: MIT

Scope

Included in the public package:

• Intraday/options backtest runtime
• Opening-range profile registry and profile helpers
• CuteMarkets and Alpaca provider adapters used by the runtime
• Walk-forward robustness helpers

For the implementation principles behind the runtime, read the Backtesting Framework knowledge base. It explains the data model, replay loop, contract selector, execution realism layer, robustness workflow, and regression test plan that a realistic options framework should preserve.

Not included:

• Live or paper trading bots
• Azure launch scripts and server tooling
• Phase routing and dashboard code
• Congressional-disclosure and Dan Meuser research pipelines

Install

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e '.[dev]'

Environment

The public package uses package-local paths and reads market-data credentials from your environment:

export CUTEBACKTESTS_DATA_DIR=data
export CUTEBACKTESTS_DB_PATH=data/cutebacktests.duckdb
export POLYGON_API_KEY=...
export ALPACA_API_KEY=...
export ALPACA_SECRET_KEY=...

CLI

Show the public CLI:

python -m cutebacktests.cli --help

Run the intraday/options backtester:

python -m cutebacktests.cli run-intraday-options-backtest \
  --ticker SPY \
  --start 2025-01-01 \
  --end 2025-12-31

Run a named opening-range profile:

python -m cutebacktests.cli run-opening-range-profile-backtest \
  --profile-name c4_long_only_rr15 \
  --ticker SPY \
  --start 2025-01-01 \
  --end 2025-12-31

Renamed API Surface

The public extraction removes legacy reddit_* naming and exposes behavior-based modules instead.

Python Example

from datetime import datetime

from cutebacktests.backtest import IntradayOptionsBacktestConfig, IntradayOptionsBacktester
from cutebacktests.profiles import get_opening_range_profile

profile = get_opening_range_profile("c4_long_only_rr15")
config = IntradayOptionsBacktestConfig(
    ticker="SPY",
    start=datetime(2025, 1, 1),
    end=datetime(2025, 3, 31),
    **profile.to_intraday_strategy_kwargs(),
)

backtester = IntradayOptionsBacktester(...)
result = backtester.run(config)

Providers

cutebacktests is designed around:

• CuteMarkets for options and market-history retrieval
• Alpaca for shared market-data surfaces used by the runtime

The library is a research/backtesting package, not a live-trading product.

How it should be used

Use cutebacktests when you want a reproducible research harness rather than a one-off notebook. The package is designed to make strategy configuration, provider access, contract selection, execution assumptions, and result artifacts explicit. That structure is useful when a backtest needs to be reviewed later or compared against a paper-trading candidate.

The public package intentionally excludes deployment code and private research orchestration. That boundary keeps the library focused on repeatable local research: define a profile, run a backtest over a known date range, inspect the artifacts, and decide whether the setup deserves further validation. Live trading, production scheduling, and account operations should remain outside this package.

Reproducibility checklist

• Pin the package version or commit hash used for a research run.
• Store the strategy profile name and full resolved configuration.
• Record the market-data provider, date range, ticker, and option-selection rules.
• Preserve output artifacts instead of relying only on a final return metric.
• Re-run the same profile after dependency or data-provider changes.

The goal is not only to produce a performance number. The goal is to produce enough evidence that another developer can understand how the result was created and why the next experiment is different.