Skip to content

coding-kitties/investing-algorithm-framework

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

1,566 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Investing Algorithm Framework

Create trading strategies. Compare them side by side. Pick the best one. πŸš€

dashboard

Sponsored by
Finterion
Marketplace for trading bots

Introduction

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

Usage

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_function

The 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

Plugins

Plugin Description
PyIndicators Technical analysis indicators (EMA, RSI, MACD, etc.)
Finterion Plugin Share and monetize strategies on Finterion's marketplace

Development

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

Resources

Contributing

Risk Disclaimer

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.

Acknowledgements

We want to thank all contributors to this project. A full list can be found in AUTHORS.md.

Sponsor

Finterion

Finterion β€” Marketplace for trading bots. Monetize your strategies by publishing them on Finterion.