Python Backtesting library for trading strategies

mementum, updated 🕥 2023-03-10 06:44:04


.. image:: :alt: PyPi Version :scale: 100% :target:

.. .. image:: :alt: PyPi Monthly Donwloads :scale: 100% :target:

.. image:: :alt: License :scale: 100% :target: .. image:: :alt: Travis-ci Build Status :scale: 100% :target: .. image:: :alt: Python versions :scale: 100% :target:

Yahoo API Note:

[2018-11-16] After some testing it would seem that data downloads can be again relied upon over the web interface (or API v7)


The ticket system is (was, actually) more often than not abused to ask for advice about samples.

For feedback/questions/... use the Community <>_

Here a snippet of a Simple Moving Average CrossOver. It can be done in several different ways. Use the docs (and examples) Luke! ::

from datetime import datetime import backtrader as bt

class SmaCross(bt.SignalStrategy): def init(self): sma1, sma2 = bt.ind.SMA(period=10), bt.ind.SMA(period=30) crossover = bt.ind.CrossOver(sma1, sma2) self.signal_add(bt.SIGNAL_LONG, crossover)

cerebro = bt.Cerebro() cerebro.addstrategy(SmaCross)

data0 = bt.feeds.YahooFinanceData(dataname='MSFT', fromdate=datetime(2011, 1, 1), todate=datetime(2012, 12, 31)) cerebro.adddata(data0) cerebro.plot()

Including a full featured chart. Give it a try! This is included in the samples as sigsmacross/ Along it is which can be parametrized from the command line.


Live Trading and backtesting platform written in Python.

  • Live Data Feed and Trading with

    • Interactive Brokers (needs IbPy and benefits greatly from an installed pytz)
    • Visual Chart (needs a fork of comtypes until a pull request is integrated in the release and benefits from pytz)
    • Oanda (needs oandapy) (REST API Only - v20 did not support streaming when implemented)
  • Data feeds from csv/files, online sources or from pandas and blaze

  • Filters for datas, like breaking a daily bar into chunks to simulate intraday or working with Renko bricks
  • Multiple data feeds and multiple strategies supported
  • Multiple timeframes at once
  • Integrated Resampling and Replaying
  • Step by Step backtesting or at once (except in the evaluation of the Strategy)
  • Integrated battery of indicators
  • TA-Lib indicator support (needs python ta-lib / check the docs)
  • Easy development of custom indicators
  • Analyzers (for example: TimeReturn, Sharpe Ratio, SQN) and pyfolio integration (deprecated)
  • Flexible definition of commission schemes
  • Integrated broker simulation with Market, Close, Limit, Stop, StopLimit, StopTrail, StopTrailLimitand OCO orders, bracket order, slippage, volume filling strategies and continuous cash adjustmet for future-like instruments
  • Sizers for automated staking
  • Cheat-on-Close and Cheat-on-Open modes
  • Schedulers
  • Trading Calendars
  • Plotting (requires matplotlib)


The blog:

  • Blog <>_

Read the full documentation at:

  • Documentation <>_

List of built-in Indicators (122)

  • Indicators Reference <>_

Python 2/3 Support

  • Python >= 3.2

  • It also works with pypy and pypy3 (no plotting - matplotlib is not supported under pypy)


backtrader is self-contained with no external dependencies (except if you want to plot)

From pypi:

  • pip install backtrader

  • pip install backtrader[plotting]

    If matplotlib is not installed and you wish to do some plotting

.. note:: The minimum matplotlib version is 1.4.1

An example for IB Data Feeds/Trading:

  • IbPy doesn't seem to be in PyPi. Do either::

    pip install git+

    or (if git is not available in your system)::

    pip install

For other functionalities like: Visual Chart, Oanda, TA-Lib, check the dependencies in the documentation.

From source:

  • Place the backtrader directory found in the sources inside your project

Version numbering


  • X: Major version number. Should stay stable unless something big is changed like an overhaul to use numpy
  • Y: Minor version number. To be changed upon adding a complete new feature or (god forbids) an incompatible API change.
  • Z: Revision version number. To be changed for documentation updates, small changes, small bug fixes
  • I: Number of Indicators already built into the platform


ERROR: __len__() should return >= 0 on live feed fixed

opened on 2023-03-09 13:00:25 by skkarwasra02 None

Here you can find a link for new backtrader with 2 commits !! You can post your commits in my repository - I will apply them!

opened on 2022-09-18 05:26:44 by WISEPLAT

By this link you can suggest your commits, I will apply them ASAP. This suggestion is made here, because of no one here doesn't want to continue this cool project!

1st commit: Option to change background for plotted value tags for dark theme - to get dark theme))) When you use dark theme you need to change background for plotted value tags.

2nd commit: Fix: In last Python versions collections.Iterable -> collections.abcIterable - to work with Python 3.11+ Please review and approve it if you have time. Thanks.

Bugfix for NaN values in bbroker data.close[0]

opened on 2022-04-27 09:26:40 by 1D0BE

,This fixes the backtest broker displaying NaN for the portfolio value returned by get_value/getvalue, even if there are no positions in the data feeds where the data.close[0] value is NaN.

Practical Example: One wants to backtest multiple data feeds of different assets over various times. Backtrader is prefilled with all assets, but cannot invest in stocks that haven't IPOed yet, for example. Nevertheless, the data feed is already loaded. This problem was also discussed here

Fix: - add python standard math dependency for isnan() - check for NaN when computing the portfolio value. - continue the value calculation loop if the closing price of the asset is NaN, no matter the position. If there is one, its worthless anyways.

Potential loopholes of fix: - None is not yet checked for - Infinity is not yet checked for.

Resolves resampling issues due to timezone differences.

opened on 2022-02-28 14:15:09 by sohamsjain

Datafeed sourced from IB API receives timezone info from contractdetails. This tz info was not passed to num2date() method in lines 275 and 276. This results in an offset in the point value returned by self._gettmpoint(tm). This offset distorts the resampling and produces bars at irregular intervals. Above modifications takes care of the same.

Note: Modified code was tested on Minute 1 timeframe resampled to 20, 25 & 75 minutes using ibdata and data form local csv file.

Update to

opened on 2022-01-21 15:41:18 by dekaravanhoc

Updates to for instance check Adds try/except for backwardscompatibility

Update to

opened on 2022-01-21 15:40:33 by dekaravanhoc

Updates to for instance check Adds try/except for backwardscompatibility

python trading backtesting metaclass