bbstrader 0.2.4__py3-none-any.whl

bbstrader-0.2.4.dist-info/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.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,37 @@
+bbstrader/__ini__.py,sha256=c2TwxnJi0PtvigdAbAS2wsTAd7CnvwRHUrYr-s4wEsI,567
+bbstrader/config.py,sha256=mdzx-xKLnEOpVYkS-0EarEl1BI1Mhcwgp7WgymJUgD0,4086
+bbstrader/tseries.py,sha256=GYNDo03dYEnYHwcQYKpclNDGCwvZ_qAPyou0vhQndS0,69851
+bbstrader/btengine/__init__.py,sha256=FL0kC0NcsnlTH-yuTv4lu6AexY1wZKN1AQ9rv9MZagQ,3009
+bbstrader/btengine/backtest.py,sha256=ZzGhoN-_g0cF-OCyk173imze2OXEhykHTUiJ9MowDO8,14582
+bbstrader/btengine/data.py,sha256=qVDk-cIgtWAeBM5eW08j9MFXBzu4yeWChoFIL9WINYI,26899
+bbstrader/btengine/event.py,sha256=38mhZH9d53C4x7bZER2B0O6M18txzS4u7zveKyxeP5Y,8603
+bbstrader/btengine/execution.py,sha256=DTsONYzc6B3wgPVxhCjWCgQhPofMJQmVOycBVkhIdgM,10368
+bbstrader/btengine/performance.py,sha256=0meGbMFYzzI9n_09qf4RFpdyqQmCa6C_iu6PvE2POIE,10787
+bbstrader/btengine/portfolio.py,sha256=M97FONcdZRoSKFFF66LRsO8_KLXr128AI5-LULhMiKk,16167
+bbstrader/btengine/strategy.py,sha256=21LSf3Jn2WBbqj9x0a8voU_xw_Q7_Uja-NLX00FRE9U,31749
+bbstrader/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+bbstrader/core/data.py,sha256=3_odj9jxokyKU15j1aHTlgLQDjW75tKqGpCUfkpYq2Q,452
+bbstrader/core/utils.py,sha256=oB4OC0tQDJ1FIaJCuNWUlTzOccHoACSJsP_f7ELrqXQ,1448
+bbstrader/ibkr/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+bbstrader/ibkr/utils.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+bbstrader/metatrader/__init__.py,sha256=rrL_EtecsOCD2Cwhmpgta5CjSGT0K6vzSBiQoyCLe3M,283
+bbstrader/metatrader/account.py,sha256=uuHZcc_bJOzrCIrXzMoMtkl41EVPep1jqNrOMfYl14E,56895
+bbstrader/metatrader/rates.py,sha256=12hNcjRSKcOSjBAhDvpakqAiLaI0ndU6oBhCTIWDzr0,21089
+bbstrader/metatrader/risk.py,sha256=2PtmQayzKXP3LFIf5xsnHjxy4_xvvjoShITyclreJAU,26901
+bbstrader/metatrader/trade.py,sha256=9yd9h16b7u3-2jpBmSFvlJ6rR6lrijgIlSoow7W-Q0c,72977
+bbstrader/metatrader/utils.py,sha256=UnwWmmfgY-Cw1V0vL14ehuWr9AhjcJMtVZK8k19b0i4,17672
+bbstrader/models/__init__.py,sha256=SnGBMQ-zcUIpms3oNeqg7EVDFpg-7OPjNAD8kvi_Q84,508
+bbstrader/models/factors.py,sha256=dWuXh83hLkwxUp3XwjgUl-r3_cjVcV_s0aFRlSLIfo8,13332
+bbstrader/models/ml.py,sha256=ipnrjcjigp1OgKd0XmoiNu_6s1gfzwqe8BiClymS4vs,48483
+bbstrader/models/optimization.py,sha256=gp0n9a9vwbUldaNiZUYry_4RP2NW0VFZ2k5NoOkz30c,6581
+bbstrader/models/portfolio.py,sha256=-Zq9cmzyOZUlGq9RWfAxClpX0KJZqYZYpc5EGNTcPGI,8302
+bbstrader/models/risk.py,sha256=IFQoHXxpBwJiifANRgwyAUOp7EgTWBAhfJFCO1sGR3g,15405
+bbstrader/trading/__init__.py,sha256=2VoxbzfP1XBLVuxJtjRhjEBCtnv9HqwQzfMV4B5mM7M,468
+bbstrader/trading/execution.py,sha256=3HlsgXcCqG6P4_F3d5uUQPVE-clsX6_frxyo3fiEuRA,30723
+bbstrader/trading/scripts.py,sha256=pNwHr-3mW87G5fyIMd93wS43NkzOZn4npt4fLNnSUyk,1922
+bbstrader/trading/strategies.py,sha256=rMvLIhX_8MQg7_Lbo127UqdTRxBUof2m3jgRQTm55p0,37019
+bbstrader-0.2.4.dist-info/LICENSE,sha256=P3PBO9RuYPzl6-PkjysTNnwmwMB64ph36Bz9DBj8MS4,1115
+bbstrader-0.2.4.dist-info/METADATA,sha256=auTcIKlFPWncc9W9rvLR3fOmwn_KhO4DlyZuxQnHNns,10399
+bbstrader-0.2.4.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+bbstrader-0.2.4.dist-info/top_level.txt,sha256=Wwj322jZmxGZ6gD_TdaPiPLjED5ReObm5omerwlmZIg,10
+bbstrader-0.2.4.dist-info/RECORD,,

bbstrader-0.2.4.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (75.8.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

bbstrader-0.2.4.dist-info/top_level.txt

@@ -0,0 +1 @@
+bbstrader