Create trading strategies. Compare them side by side. Pick the best one. π
Sponsored by
Marketplace for trading bots
Investing Algorithm Framework is a Python framework for creating, backtesting, and deploying trading strategies.
Most quant frameworks stop at "here's your backtest result." You get a number, maybe a chart, and then you're on your own figuring out which strategy is actually better.
This framework is built around the full loop: create strategies β backtest them β compare them in a single report β deploy the winner. It generates a self-contained HTML dashboard that lets you rank, filter, and visually compare every strategy you've tested β all in one view, no notebooks required.
Features
- π 30+ Metrics β CAGR, Sharpe, Sortino, Calmar, VaR, CVaR, Max DD, Recovery & more
- βοΈ Multi-Strategy Comparison β Rank, filter & compare strategies in a single interactive report
- πͺ Multi-Window Robustness β Test across different time periods with window coverage analysis
- π Equity & Drawdown Charts β Overlay equity curves, rolling Sharpe, drawdown & return distributions
- ποΈ Monthly Heatmaps & Yearly Returns β Calendar heatmap per strategy with return/growth toggles
- π― Return Scenario Projections β Good, average, bad & very bad year projections from backtest data
- π Benchmark Comparison β Beat-rate analysis vs Buy & Hold, DCA, risk-free & custom benchmarks
- π One-Click HTML Report β Self-contained file, no server, dark & light theme, shareable
- π Build β Backtest β Deploy β Local dev, cloud deploy (AWS / Azure), or monetize on Finterion
To get started, install the framework and scaffold a new project:
pip install investing-algorithm-framework
# Generate project structure
investing-algorithm-framework init
# Or for cloud deployment
investing-algorithm-framework init --type aws_lambda
investing-algorithm-framework init --type azure_functionThe documentation provides guides and API reference. The quick start will walk you through your first strategy.
Creating a Strategy
The framework is designed around the TradingStrategy class. You define what data your strategy needs and when to buy or sell β the framework handles execution, position management, and reporting.
from investing_algorithm_framework import (
TradingStrategy, TimeUnit, Context, OrderSide
)
class MyStrategy(TradingStrategy):
time_unit = TimeUnit.HOUR
interval = 2
symbol_pairs = ["BTC/EUR"]
def apply_strategy(self, context: Context, market_data):
for pair in self.symbol_pairs:
symbol = pair.split("/")[0]
ohlcv = market_data[f"{pair}-ohlcv-2h"]
price = ohlcv["Close"].iloc[-1]
if self.should_buy(ohlcv) and not context.has_position(symbol):
context.create_limit_order(
target_symbol=symbol,
order_side=OrderSide.BUY,
price=price,
percentage_of_portfolio=25,
)
if self.should_sell(ohlcv) and context.has_position(symbol):
context.create_limit_order(
target_symbol=symbol,
order_side=OrderSide.SELL,
price=price,
percentage_of_portfolio=100,
)Create as many strategy variants as you want β different parameters, different indicators, different symbols β then backtest them all and compare in a single report.
Backtest Report Dashboard
Every backtest produces a single HTML file you can open in any browser, share with teammates, or archive. No server, no dependencies, no Jupyter required.
from investing_algorithm_framework import BacktestReport
# After running backtests
report = BacktestReport(backtest)
report.show() # Opens dashboard in your browser
# Or load previously saved backtests from disk
report = BacktestReport.open(directory_path="path/to/backtests")
report.show()
# Compare multiple strategies side by side
report = BacktestReport.open(backtests=[backtest_a, backtest_b, backtest_c])
report.show()
# Save as a self-contained HTML file
report.save("my_report.html")Overview page β KPI cards, key metrics ranking table, trading activity, return scenarios, equity curves, metric bar charts, monthly returns heatmap, return distributions, and window coverage matrix.
Strategy pages β Deep dive into each strategy with per-run equity curves, rolling Sharpe, drawdown, monthly/yearly returns, and portfolio summary.
Capabilities
| Backtest Report Dashboard | Self-contained HTML report with ranking tables, equity curves, metric charts, heatmaps, and strategy comparison |
| Event-Driven Backtesting | Realistic, order-by-order simulation |
| Vectorized Backtesting | Fast signal research and prototyping |
| 50+ Metrics | CAGR, Sharpe, Sortino, max drawdown, win rate, profit factor, recovery factor, volatility, and more |
| Live Trading | Connect to exchanges via CCXT for real-time execution |
| Portfolio Management | Position tracking, trade management, persistence |
| Cloud Deployment | Deploy to AWS Lambda, Azure Functions, or run as a web service |
| Market Data | OHLCV, tickers, custom data β Polars and Pandas native |
| Extensible | Custom data providers, order executors, and strategy classes |
| Plugin | Description |
|---|---|
| PyIndicators | Technical analysis indicators (EMA, RSI, MACD, etc.) |
| Finterion Plugin | Share and monetize strategies on Finterion's marketplace |
git clone https://github.com/coding-kitties/investing-algorithm-framework.git
cd investing-algorithm-framework
poetry install
# Run all tests
python -m unittest discover -s tests- Documentation β Guides and API reference
- Quick Start β Get up and running
- Discord β Chat and support
- Reddit β Strategy discussion
- Open an issue for bugs or ideas
- Read the Contributing Guide
- PRs go against the
developbranch
If you use this framework for real trading, do not risk money you are afraid to lose. Test thoroughly with backtesting first. Start small. We assume no responsibility for your investment results.
We want to thank all contributors to this project. A full list can be found in AUTHORS.md.
Finterion β Marketplace for trading bots. Monetize your strategies by publishing them on Finterion.