bbstrader 0.2.4__tar.gz

bbstrader-0.2.4/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2023-2025 Bertin Balouki SIMYELI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bbstrader-0.2.4/MANIFEST.in

@@ -0,0 +1 @@
+include requirements.txt

bbstrader-0.2.4/PKG-INFO

@@ -0,0 +1,174 @@
+Metadata-Version: 2.2
+Name: bbstrader
+Version: 0.2.4
+Summary: Simplified Investment & Trading Toolkit
+Home-page: https://github.com/bbalouki/bbstrader
+Download-URL: https://pypi.org/project/bbstrader/
+Author: Bertin Balouki SIMYELI
+Author-email: <bertin@bbstrader.com>
+Maintainer: Bertin Balouki SIMYELI
+License: The MIT License (MIT)
+Project-URL: Documentation, https://bbstrader.readthedocs.io/en/latest/
+Project-URL: Source Code, https://github.com/bbalouki/bbstrader
+Keywords: Finance,Toolkit,Financial,Analysis,Fundamental,Quantitative,Database,Equities,Currencies,Economics,ETFs,Funds,Indices,Moneymarkets,Commodities,Futures,CFDs,Derivatives,Trading,Investing,Portfolio,Optimization,Performance
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: License :: OSI Approved :: MIT License
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas
+Requires-Dist: pandas_ta
+Requires-Dist: numpy==1.26.4
+Requires-Dist: yfinance
+Requires-Dist: scipy
+Requires-Dist: hmmlearn
+Requires-Dist: pmdarima
+Requires-Dist: arch
+Requires-Dist: hurst
+Requires-Dist: seaborn
+Requires-Dist: statsmodels
+Requires-Dist: matplotlib
+Requires-Dist: filterpy
+Requires-Dist: pykalman
+Requires-Dist: pytest
+Requires-Dist: CurrencyConverter
+Requires-Dist: tabulate
+Requires-Dist: python-dotenv
+Requires-Dist: ipython
+Requires-Dist: QuantStats
+Requires-Dist: exchange-calendars
+Requires-Dist: tqdm
+Requires-Dist: scikit-learn
+Requires-Dist: notify-py
+Requires-Dist: python-telegram-bot
+Requires-Dist: pyportfolioopt
+Requires-Dist: eodhd
+Requires-Dist: financetoolkit
+Requires-Dist: tables
+Requires-Dist: lightgbm
+Requires-Dist: alphalens-reloaded
+Provides-Extra: mt5
+Requires-Dist: MetaTrader5; extra == "mt5"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: download-url
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: maintainer
+Dynamic: project-url
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: summary
+
+# Simplified Investment & Trading Toolkit
+![bbstrader](https://github.com/bbalouki/bbstrader/blob/main/assets/bbstrader_logo.png?raw=true)
+
+[![Documentation Status](https://readthedocs.org/projects/bbstrader/badge/?version=latest)](https://bbstrader.readthedocs.io/en/latest/?badge=latest)
+
+[Dcoumentation](https://bbstrader.readthedocs.io/en/latest/index.html)
+
+## Overview
+
+BBSTrader is a trading system suite developed for MetaTrader 5 (MT5) and IBKR platforms (comming soon), designed to offer a comprehensive set of tools for developping, backtesting, executing, and managing a wide array of trading strategies. With an emphasis on algorithmic and quantitative trading to provide traders with a robust platform for exploring and deploying sophisticated trading strategies.
+
+`bbstrader` is comprised of several key modules, each focus on specific aspects of trading strategy development and execution:
+
+- **Backtesting Module (btengine)** : Enables traders to rigorously test their trading strategies using historical data to evaluate performance before live deployment.
+- **Trading Strategies Module**: A collection of predefined trading strategies, including ARIMA+GARCH models, Kalman Filters, and Simple Moving Averages, equipped with risk management through Hidden Markov Models.
+- **MetaTrader5 Module (metatrader)**: Facilitates the direct execution of trading strategies on the MetaTrader 5 platform, supporting real-time trading across multiple financial instruments.
+- **Modles Module**: Serves as a framework for implementing various types of financial models (risk managment models, Machine learing models etc).
+- **Time serie Module (tseries)** designed for conducting advanced time series analysis in financial markets. 
+It leverages statistical models and algorithms to perform tasks such as cointegration testing, volatility modeling, and filter-based estimation to assist in trading strategy development, market analysis, and financial data exploration.
+
+## Features
+
+- **Comprehensive Backtesting**: Assess the performance of trading strategies with historical market data to optimize parameters and strategies for live trading environments.
+- **Integrated Risk Management**: Leverage advanced risk management techniques to adapt to changing market conditions and maintain control over risk exposure.
+- **Automated Trading**: Execute trades automatically on the MT5 platform, with support for managing orders, positions, and risk in real-time.
+- **Flexible Framework**: Customize existing strategies or develop new ones with the flexible, modular architecture designed to accommodate traders' evolving needs.
+- **Advanced Time Series Analysis**: Conduct in-depth analysis of financial time series data to identify patterns, trends, and relationships that can inform trading strategies.
+You can read the full documentation [here](https://bbstrader.readthedocs.io/en/latest/index.html)
+
+## Getting Started
+
+Before you can use the bbstrader and the metratrader, you need to have MetaTrader 5 (MT5) installed on your computer and an active MT5 trading account. 
+This Module currenlty support three brokers, [Admirals Group AS](https://cabinet.a-partnership.com/visit/?bta=35537&brand=admiralmarkets), [Just Global Markets Ltd.](https://one.justmarkets.link/a/tufvj0xugm/registration/trader), and [FTMO](https://trader.ftmo.com/?affiliates=JGmeuQqepAZLMcdOEQRp), so you need to create a demo or live account with one of them.
+* If you want to trade `Stocks`, `ETFs`, `Indices`, `Commodities`, `Futures`, and `Forex`, [click here](https://cabinet.a-partnership.com/visit/?bta=35537&brand=admiralmarkets)
+* If you want to trade `Stocks`, `Crypto`, `indices`, `Commodities`, and `Forex`, [click here](https://one.justmarkets.link/a/tufvj0xugm/registration/trader)
+* If you are looking for a prop firm, [click here](https://trader.ftmo.com/?affiliates=JGmeuQqepAZLMcdOEQRp)
+
+Then, you can install `bbstrader` using pip:
+```bash
+pip install bbstrader
+```
+
+## Examples
+### Backtesting Module
+```python
+from bbstrader.trading.strategies import test_strategy
+
+if __name__ == '__main__':
+    # Run backtesting for Stock Index Short Term Buy Only Strategy
+    test_strategy(strategy='sistbo')
+    
+```
+### Backtesting Results
+![Backtesting Results 1](https://github.com/bbalouki/bbstrader/blob/main/assets/bbs_.png?raw=true)
+![Backtesting Results 2](https://github.com/bbalouki/bbstrader/blob/main/assets/qs_metrics_1.png?raw=true)
+![Backtesting Results 3](https://github.com/bbalouki/bbstrader/blob/main/assets/qs_metrics_2.png?raw=true)
+![Backtesting Results 4](https://github.com/bbalouki/bbstrader/blob/main/assets/qs_plots_1_.png?raw=true)
+![Backtesting Results 5](https://github.com/bbalouki/bbstrader/blob/main/assets/qs_plots_2_.png?raw=true)
+
+## Customization and Contribution
+
+`bbstrader`'s modular design allows for easy customization and extension. Traders and developers are encouraged to modify existing strategies, add new ones, or enhance the system's capabilities. Contributions to the `bbstrader` project are welcome.
+
+## Contributing to BBSTrader
+
+We warmly welcome contributions from the trading and development community! Whether you're interested in fixing bugs, adding new features, or improving documentation, your help is invaluable to making `bbstrader` more robust and versatile. Here's how you can contribute:
+
+### Ways to Contribute
+
+- **Develop New Strategies**: Implement and share your unique trading strategies or models.
+- **Enhance Existing Modules**: Optimize the performance, extend the functionality, or improve the usability of existing modules.
+- **Report Bugs**: Identify and report bugs to help us improve the system's stability and performance.
+- **Improve Documentation**: Contribute to the project's documentation for clearer guidance and better usability.
+- **Share Insights and Best Practices**: Provide examples, tutorials, or best practices on utilizing `bbstrader` effectively.
+
+### How to Get Started
+
+1. **Fork the Repository**: Start by forking the `bbstrader` repository to your GitHub account.
+2. **Clone Your Fork**: Clone your forked repository to your local machine to start making changes.
+3. **Set Up Your Development Environment**: Ensure you have the necessary development environment set up, including Python, MetaTrader 5, and any dependencies.
+4. **Create a New Branch**: Make your changes in a new git branch, branching off from the main branch.
+5. **Implement Your Changes**: Work on bug fixes, features, or documentation improvements.
+6. **Test Your Changes**: Ensure your changes do not introduce new issues and that they work as intended.
+7. **Submit a Pull Request**: Once you're ready, submit a pull request (PR) against the main `bbstrader` repository. Include a clear description of the changes and any other relevant information.
+
+### Contribution Guidelines
+
+Please adhere to the following guidelines to ensure a smooth contribution process:
+
+- **Follow the Coding Standards**: Write clean, readable code and follow the coding conventions used throughout the project.
+- **Document Your Changes**: Add comments and update the README.md files as necessary to explain your changes or additions.
+- **Respect the License**: All contributions are subject to the MIT License under which `bbstrader` is distributed.
+
+We're excited to see your contributions and to welcome you to the `bbstrader` community. Together, we can build a powerful tool that serves the needs of traders around the world.
+
+
+## Disclaimer
+
+Trading financial instruments involves a high level of risk and may not be suitable for all investors. The developers of `bbstrader` are not responsible for any financial losses incurred from the use of this software. Trade responsibly and at your own risk.
+
+## License
+`bbstrader` is open source and available under the MIT License.

bbstrader-0.2.4/README.md

@@ -0,0 +1,102 @@
+# Simplified Investment & Trading Toolkit
+![bbstrader](https://github.com/bbalouki/bbstrader/blob/main/assets/bbstrader_logo.png?raw=true)
+
+[![Documentation Status](https://readthedocs.org/projects/bbstrader/badge/?version=latest)](https://bbstrader.readthedocs.io/en/latest/?badge=latest)
+
+[Dcoumentation](https://bbstrader.readthedocs.io/en/latest/index.html)
+
+## Overview
+
+BBSTrader is a trading system suite developed for MetaTrader 5 (MT5) and IBKR platforms (comming soon), designed to offer a comprehensive set of tools for developping, backtesting, executing, and managing a wide array of trading strategies. With an emphasis on algorithmic and quantitative trading to provide traders with a robust platform for exploring and deploying sophisticated trading strategies.
+
+`bbstrader` is comprised of several key modules, each focus on specific aspects of trading strategy development and execution:
+
+- **Backtesting Module (btengine)** : Enables traders to rigorously test their trading strategies using historical data to evaluate performance before live deployment.
+- **Trading Strategies Module**: A collection of predefined trading strategies, including ARIMA+GARCH models, Kalman Filters, and Simple Moving Averages, equipped with risk management through Hidden Markov Models.
+- **MetaTrader5 Module (metatrader)**: Facilitates the direct execution of trading strategies on the MetaTrader 5 platform, supporting real-time trading across multiple financial instruments.
+- **Modles Module**: Serves as a framework for implementing various types of financial models (risk managment models, Machine learing models etc).
+- **Time serie Module (tseries)** designed for conducting advanced time series analysis in financial markets. 
+It leverages statistical models and algorithms to perform tasks such as cointegration testing, volatility modeling, and filter-based estimation to assist in trading strategy development, market analysis, and financial data exploration.
+
+## Features
+
+- **Comprehensive Backtesting**: Assess the performance of trading strategies with historical market data to optimize parameters and strategies for live trading environments.
+- **Integrated Risk Management**: Leverage advanced risk management techniques to adapt to changing market conditions and maintain control over risk exposure.
+- **Automated Trading**: Execute trades automatically on the MT5 platform, with support for managing orders, positions, and risk in real-time.
+- **Flexible Framework**: Customize existing strategies or develop new ones with the flexible, modular architecture designed to accommodate traders' evolving needs.
+- **Advanced Time Series Analysis**: Conduct in-depth analysis of financial time series data to identify patterns, trends, and relationships that can inform trading strategies.
+You can read the full documentation [here](https://bbstrader.readthedocs.io/en/latest/index.html)
+
+## Getting Started
+
+Before you can use the bbstrader and the metratrader, you need to have MetaTrader 5 (MT5) installed on your computer and an active MT5 trading account. 
+This Module currenlty support three brokers, [Admirals Group AS](https://cabinet.a-partnership.com/visit/?bta=35537&brand=admiralmarkets), [Just Global Markets Ltd.](https://one.justmarkets.link/a/tufvj0xugm/registration/trader), and [FTMO](https://trader.ftmo.com/?affiliates=JGmeuQqepAZLMcdOEQRp), so you need to create a demo or live account with one of them.
+* If you want to trade `Stocks`, `ETFs`, `Indices`, `Commodities`, `Futures`, and `Forex`, [click here](https://cabinet.a-partnership.com/visit/?bta=35537&brand=admiralmarkets)
+* If you want to trade `Stocks`, `Crypto`, `indices`, `Commodities`, and `Forex`, [click here](https://one.justmarkets.link/a/tufvj0xugm/registration/trader)
+* If you are looking for a prop firm, [click here](https://trader.ftmo.com/?affiliates=JGmeuQqepAZLMcdOEQRp)
+
+Then, you can install `bbstrader` using pip:
+```bash
+pip install bbstrader
+```
+
+## Examples
+### Backtesting Module
+```python
+from bbstrader.trading.strategies import test_strategy
+
+if __name__ == '__main__':
+    # Run backtesting for Stock Index Short Term Buy Only Strategy
+    test_strategy(strategy='sistbo')
+    
+```
+### Backtesting Results
+![Backtesting Results 1](https://github.com/bbalouki/bbstrader/blob/main/assets/bbs_.png?raw=true)
+![Backtesting Results 2](https://github.com/bbalouki/bbstrader/blob/main/assets/qs_metrics_1.png?raw=true)
+![Backtesting Results 3](https://github.com/bbalouki/bbstrader/blob/main/assets/qs_metrics_2.png?raw=true)
+![Backtesting Results 4](https://github.com/bbalouki/bbstrader/blob/main/assets/qs_plots_1_.png?raw=true)
+![Backtesting Results 5](https://github.com/bbalouki/bbstrader/blob/main/assets/qs_plots_2_.png?raw=true)
+
+## Customization and Contribution
+
+`bbstrader`'s modular design allows for easy customization and extension. Traders and developers are encouraged to modify existing strategies, add new ones, or enhance the system's capabilities. Contributions to the `bbstrader` project are welcome.
+
+## Contributing to BBSTrader
+
+We warmly welcome contributions from the trading and development community! Whether you're interested in fixing bugs, adding new features, or improving documentation, your help is invaluable to making `bbstrader` more robust and versatile. Here's how you can contribute:
+
+### Ways to Contribute
+
+- **Develop New Strategies**: Implement and share your unique trading strategies or models.
+- **Enhance Existing Modules**: Optimize the performance, extend the functionality, or improve the usability of existing modules.
+- **Report Bugs**: Identify and report bugs to help us improve the system's stability and performance.
+- **Improve Documentation**: Contribute to the project's documentation for clearer guidance and better usability.
+- **Share Insights and Best Practices**: Provide examples, tutorials, or best practices on utilizing `bbstrader` effectively.
+
+### How to Get Started
+
+1. **Fork the Repository**: Start by forking the `bbstrader` repository to your GitHub account.
+2. **Clone Your Fork**: Clone your forked repository to your local machine to start making changes.
+3. **Set Up Your Development Environment**: Ensure you have the necessary development environment set up, including Python, MetaTrader 5, and any dependencies.
+4. **Create a New Branch**: Make your changes in a new git branch, branching off from the main branch.
+5. **Implement Your Changes**: Work on bug fixes, features, or documentation improvements.
+6. **Test Your Changes**: Ensure your changes do not introduce new issues and that they work as intended.
+7. **Submit a Pull Request**: Once you're ready, submit a pull request (PR) against the main `bbstrader` repository. Include a clear description of the changes and any other relevant information.
+
+### Contribution Guidelines
+
+Please adhere to the following guidelines to ensure a smooth contribution process:
+
+- **Follow the Coding Standards**: Write clean, readable code and follow the coding conventions used throughout the project.
+- **Document Your Changes**: Add comments and update the README.md files as necessary to explain your changes or additions.
+- **Respect the License**: All contributions are subject to the MIT License under which `bbstrader` is distributed.
+
+We're excited to see your contributions and to welcome you to the `bbstrader` community. Together, we can build a powerful tool that serves the needs of traders around the world.
+
+
+## Disclaimer
+
+Trading financial instruments involves a high level of risk and may not be suitable for all investors. The developers of `bbstrader` are not responsible for any financial losses incurred from the use of this software. Trade responsibly and at your own risk.
+
+## License
+`bbstrader` is open source and available under the MIT License.

bbstrader-0.2.4/bbstrader/__ini__.py

@@ -0,0 +1,18 @@
+"""
+Simplified Investment & Trading Toolkit
+=======================================
+
+"""
+__author__      = "Bertin Balouki SIMYELI"
+__copyright__   = "2023-2025 Bertin Balouki SIMYELI"
+__email__       = "bertin@bbstrader.com"
+__license__     = "MIT"
+__version__     = '0.2.0'
+
+
+from bbstrader import btengine  # noqa: F401
+from bbstrader import metatrader  # noqa: F401
+from bbstrader import models  # noqa: F401
+from bbstrader import trading  # noqa: F401
+from bbstrader import tseries  # noqa: F401
+from .config import config_logger  # noqa: F401

bbstrader-0.2.4/bbstrader/btengine/__init__.py

@@ -0,0 +1,54 @@
+"""
+Overview
+========
+
+This Backtesting Module provides a comprehensive suite of tools to test trading strategies in an event-driven system. 
+It simulates the execution of trades in historical market conditions to evaluate the performance of trading strategies 
+before applying them in live trading environments. Designed with modularity and extensibility in mind, it caters to 
+both novices and experts in algorithmic trading.
+
+Features
+========
+
+- **Event-Driven Architecture**: Processes market data, generates signals, executes orders, and manages portfolio updates in response to events, closely mimicking live trading environments.
+- **Historical Market Data Support**: Utilizes historical OHLCV data from CSV files, Yahoo finance and MT5 terminal allowing for the testing of strategies over various market conditions and time frames.
+- **Performance Metrics Calculation**: Includes tools for calculating key performance indicators, such as `Sharpe Ratio`, `Sortino Ratio`, and `drawdowns`, to evaluate the effectiveness of trading strategies.
+- **Visualization**: Generates plots of the `equity curve`, `returns`, `drawdowns`, and other metrics for comprehensive strategy `performance analysis`.
+
+Components
+==========
+
+- **BacktestEgine**: Orchestrates the backtesting process, managing events and invoking components.
+- **Event**: Abstract class for events, with implementations for market data, signals, fill and order events.
+- **DataHandler**: Abstract class for market data handling, with an implementation for `CSVDataHandler`, `MT5DataHandler`, `YFDataHandler`. We will add another data handling in the future such as MacroEconomic Data, Fundamental Data, TICK Data and Real-time Data.
+- **Portfolio**: Manages positions and calculates performance metrics, responding to market data and signals.
+- **ExecutionHandler**: Abstract class for order execution, with a simulated execution handler provided with an implementation for `SimExecutionHandler`.
+- **Performance**: Utility functions for calculating performance metrics and visualizing strategy performance.
+
+Examples
+========
+
+>>> from bbstrader.btengine import run_backtest
+>>> from datetime import datetime
+>>> run_backtest(
+...     symbol_list=['AAPL', 'GOOG'],
+...     start_date=datetime(2020, 1, 1),
+...     data_handler=DataHandler,
+...     strategy=Strategy,
+...     exc_handler=ExecutionHandler,
+...     initial_capital=500000.0,
+...     heartbeat=1.0
+... )
+
+Notes
+=====
+
+See `bbstrader.btengine.backtest.run_backtest` for more details on the backtesting process and its parameters.
+"""
+from bbstrader.btengine.backtest import *  # noqa: F403
+from bbstrader.btengine.data import *  # noqa: F403
+from bbstrader.btengine.event import *  # noqa: F403
+from bbstrader.btengine.execution import *  # noqa: F403
+from bbstrader.btengine.performance import *  # noqa: F403
+from bbstrader.btengine.portfolio import *  # noqa: F403
+from bbstrader.btengine.strategy import *  # noqa: F403