bbstrader 0.2.99__py3-none-any.whl → 0.2.991__py3-none-any.whl

bbstrader/__init__.py

@@ -0,0 +1,19 @@
+"""
+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 compat  # noqa: F401
+from bbstrader import core  # noqa: F401
+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 bbstrader.config import config_logger  # noqa: F401

bbstrader/btengine/event.py

@@ -2,7 +2,7 @@ from datetime import datetime
 from enum import Enum
 from typing import Literal
 
-__all__ = ["Event", "MarketEvent", "SignalEvent", "OrderEvent", "FillEvent"]
+__all__ = ["Event", "Events",  "MarketEvent", "SignalEvent", "OrderEvent", "FillEvent"]
 
 
 class Event(object):
@@ -134,20 +134,21 @@ class OrderEvent(Event):
         self.price = price
         self.signal = signal
 
-        def print_order(self):
-            """
-            Outputs the values within the Order.
-            """
-            print(
-                "Order: Symbol=%s, Type=%s, Quantity=%s, Direction=%s, Price=%s"
-                % (
-                    self.symbol,
-                    self.order_type,
-                    self.quantity,
-                    self.direction,
-                    self.price,
-                )
+    def print_order(self):
+        """
+        Outputs the values within the Order.
+        """
+        print(
+            "Order: Symbol=%s, Type=%s, Quantity=%s, Direction=%s, Price=%s"
+            % (
+                self.symbol,
+                self.order_type,
+                self.quantity,
+                self.direction,
+                self.price,
             )
+        )
+
 
 
 class FillEvent(Event):

bbstrader/core/data.py

@@ -2,7 +2,7 @@ import json
 import re
 import ssl
 from datetime import datetime
-from typing import List
+from typing import List, Literal
 from urllib.request import urlopen
 
 import certifi
@@ -18,7 +18,7 @@ __all__ = ["FmpData", "FmpNews", "FinancialNews"]
 
 
 def _get_search_query(query: str) -> str:
-    if " " in query:
+    if " " in query or query == "":
         return query
     try:
         name = yf.Ticker(query).info["shortName"]
@@ -422,6 +422,102 @@ class FinancialNews(object):
     def get_fmp_news(self, api=None) -> FmpNews:
         return FmpNews(api=api)
 
+    def get_coindesk_news(
+        self,
+        query="",
+        lang: Literal["EN", "ES", "TR", "FR", "JP", "PT"] = "EN",
+        limit=50,
+        list_of_str=False,
+    ) -> List[str] | List[dict]:
+        """
+        Fetches and filters recent news articles from CoinDesk's News API.
+
+        Args:
+            query : str, optional
+                A search term to filter articles by title, body, or keywords.
+                If empty, all articles are returned without filtering (default is "").
+
+            lang : Literal["EN", "ES", "TR", "FR", "JP", "PT"], optional
+                Language in which to fetch news articles. Supported languages:
+                English (EN), Spanish (ES), Turkish (TR), French (FR), Japanese (JP), and Portuguese (PT).
+                Default is "EN".
+
+            limit : int, optional
+                Maximum number of articles to retrieve. Default is 50.
+
+            list_of_str : bool, optional
+                If True, returns a list of strings (concatenated article content).
+                If False, returns a list of filtered article dictionaries.
+                Default is False.
+
+        Returns:
+            List[str] | List[dict]
+                - If `query` is empty: returns a list of filtered article dictionaries.
+                - If `query` is provided:
+                    - Returns a list of strings if `list_of_str=True`.
+                    - Returns a list of filtered article dictionaries otherwise.
+
+        Each article dictionary contains the following fields:
+            - 'published_on': datetime of publication
+            - 'title': article headline
+            - 'subtitle': secondary headline
+            - 'url': direct link to the article
+            - 'body': article content
+            - 'keywords': associated tags
+            - 'sentiment': sentiment label
+            - 'status': publication status
+
+        Notes:
+            - Articles marked as sponsored are automatically excluded.
+        """
+        maximum = 100
+        if limit > maximum:
+            raise ValueError(f"Number of total news articles allowed is {maximum}")
+
+        response = requests.get(
+            "https://data-api.coindesk.com/news/v1/article/list",
+            params={"lang": lang, "limit": limit},
+            headers={"Content-type": "application/json; charset=UTF-8"},
+        )
+        json_response = response.json()
+        articles = json_response["Data"]
+        if len(articles) == 0:
+            return []
+        to_keep = [
+            "PUBLISHED_ON",
+            "TITLE",
+            "SUBTITLE",
+            "URL",
+            "BODY",
+            "KEYWORDS",
+            "SENTIMENT",
+            "STATUS",
+        ]
+        filtered_articles = []
+        for article in articles:
+            filtered_articles.append(
+                {
+                    k.lower(): article[k]
+                    if k in article and k != "PUBLISHED_ON"
+                    else datetime.fromtimestamp(article[k])
+                    for k in to_keep
+                    if article[k] is not None and "sponsored" not in str(article[k])
+                }
+            )
+        if query == "" or len(filtered_articles) == 0:
+            return filtered_articles
+        to_return = []
+        query = _get_search_query(query)
+        for article in filtered_articles:
+            if not all(k in article for k in ("title", "body", "keywords")):
+                continue
+            text = article["title"] + " " + article["body"] + " " + article["keywords"]
+            if list_of_str and _find_news(query, text=text):
+                to_return.append(text)
+            if not list_of_str and _find_news(query, text=text):
+                to_return.append(article)
+        return to_return
+
 
 class FmpData(Toolkit):
     """

bbstrader/metatrader/trade.py

@@ -531,6 +531,7 @@ class Trade(RiskManagement):
             mm (bool): Weither to put stop loss and tp or not
             trail (bool): Weither to trail the stop loss or not
             comment (str): The comment for the opening position
+            volume (float): The volume (lot) to trade
             sl (float): The stop loss price
             tp (float): The take profit price
         """
@@ -621,7 +622,6 @@ class Trade(RiskManagement):
             mm (bool): Weither to put stop loss and tp or not
             trail (bool): Weither to trail the stop loss or not
             comment (str): The comment for the closing position
-                        symbol (str): The symbol to trade
             volume (float): The volume (lot) to trade
             sl (float): The stop loss price
             tp (float): The take profit price

bbstrader/models/nlp.py

@@ -506,6 +506,7 @@ class SentimentAnalyzer(object):
             reddit_posts = news.get_reddit_posts(
                 ticker, n_posts=top_news, **{k: kwargs.get(k) for k in rd_params}
             )
+            coindesk_news = news.get_coindesk_news(query=ticker, list_of_str=True)
             fmp_source_news = []
             fmp_news = news.get_fmp_news(kwargs.get("fmp_api"))
             for source in ["articles"]:  # , "releases", asset_type]:
@@ -518,7 +519,7 @@ class SentimentAnalyzer(object):
                     source_news = []
             if any([len(s) > 0 for s in [yahoo_news, google_news]]):
                 sources += 1
-            for source in [reddit_posts, fmp_source_news]:
+            for source in [reddit_posts, fmp_source_news, coindesk_news]:
                 if len(source) > 0:
                     sources += 1
             # Compute sentiment
@@ -531,11 +532,17 @@ class SentimentAnalyzer(object):
             fmp_sentiment = self.analyze_sentiment(
                 fmp_source_news, lexicon=lexicon, textblob=True
             )
+            coindesk_sentiment = self.analyze_sentiment(
+                coindesk_news, lexicon=lexicon, textblob=True
+            )
 
             # Weighted average sentiment score
             if sources != 0:
                 overall_sentiment = (
-                    news_sentiment + reddit_sentiment + fmp_sentiment
+                    news_sentiment
+                    + reddit_sentiment
+                    + fmp_sentiment
+                    + coindesk_sentiment
                 ) / sources
             else:
                 overall_sentiment = 0.0

{bbstrader-0.2.99.dist-info → bbstrader-0.2.991.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bbstrader
-Version: 0.2.99
+Version: 0.2.991
 Summary: Simplified Investment & Trading Toolkit
 Home-page: https://github.com/bbalouki/bbstrader
 Download-URL: https://pypi.org/project/bbstrader/
@@ -81,8 +81,6 @@ 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)
 [![PYPI Version](https://img.shields.io/pypi/v/bbstrader)](https://pypi.org/project/bbstrader/)
 [![PyPi status](https://img.shields.io/pypi/status/bbstrader.svg?maxAge=60)](https://pypi.python.org/pypi/bbstrader)

{bbstrader-0.2.99.dist-info → bbstrader-0.2.991.dist-info}/RECORD

@@ -1,4 +1,5 @@
 bbstrader/__ini__.py,sha256=v6zyJHj5FMRL-_P7AwnTGbCF-riMqhqlTvDgfulj7go,621
+bbstrader/__init__.py,sha256=5q_NaxJHcGYUVhC8cMWO3ZDJhjta7MrphQTYqganepY,581
 bbstrader/__main__.py,sha256=sDdjoiaHSPrVqdjU_zOLajX3rD_3Ha6dHwIivYc_vp4,1525
 bbstrader/compat.py,sha256=djbHMvTvy0HYm1zyZ6Ttp_LMwP2PqTSVw1r7pqbz7So,487
 bbstrader/config.py,sha256=c2nCUw-bYWf5kkyFls5Nqld8HdMczexSilTni7rYUBw,3973
@@ -6,14 +7,14 @@ bbstrader/tseries.py,sha256=H4D_A966HdN8YjBfuCcF8QBQdhjOrTcidR98wP2KN_I,68339
 bbstrader/btengine/__init__.py,sha256=y1btjaEfhWsH8vuE7mBRpP9Tu-Azt9REhuVYsPCAfBU,2955
 bbstrader/btengine/backtest.py,sha256=UiOmtqYSh72KZz0DCXz8iKrqTCOkx9Er3XjqK6H9Do8,14765
 bbstrader/btengine/data.py,sha256=Tuc6M8itbGpPjsfRpZBB8v0FJpPt7-hUkP6I5meP0Sg,26927
-bbstrader/btengine/event.py,sha256=gC2nqWU_t1pRzg4DYYey-mbaBo8T_JOPzzAzRF53U7o,8757
+bbstrader/btengine/event.py,sha256=Ydl1avAXp9WAWOBXDAckcb9g1UkcnCO0rRzcJZwIq20,8714
 bbstrader/btengine/execution.py,sha256=tN7QIx0PHiQmJcn3MdSQiwwAYCDxFDn3C4i5tlM5xoY,10605
 bbstrader/btengine/performance.py,sha256=1ecWrTzHBQbk4ORvbTEKxwCzlL1brcXOEUwgbnjAwx4,12470
 bbstrader/btengine/portfolio.py,sha256=z98M65HQeCyma8gMZkAxspxBA9jtIhzxMyJUHPPj34c,16128
 bbstrader/btengine/scripts.py,sha256=8o66dq4Ex4DsH4s8xvJqUOFjLzZJSnbBvvNBzohtzoE,4837
 bbstrader/btengine/strategy.py,sha256=FrYoB8ogHODTfRDZf2gW-CGdTxdVoIYwxko1cYgwcgg,31631
 bbstrader/core/__init__.py,sha256=GIFzFSStPfE0XM2j7mDeZZQeMTh_AwPsDOQXwMVJLgw,97
-bbstrader/core/data.py,sha256=VPuynoT0uFYduh7la8gZSnEv_Gq8Xu2vJZJ7TfQMll8,18797
+bbstrader/core/data.py,sha256=hStrx-QTYFjpJdZOJVtV2xmIyywj6T9_Rn3hhNYtFwU,22581
 bbstrader/core/utils.py,sha256=WjuabzBjhY65ku2KL-f7CMalE2x-wrX-6mCA_qhhFPE,2728
 bbstrader/ibkr/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 bbstrader/ibkr/utils.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -24,12 +25,12 @@ bbstrader/metatrader/copier.py,sha256=pCZkRfkUWxufnmiO0cc1Kz6UF59HTUUGs-c60LYNUb
 bbstrader/metatrader/rates.py,sha256=0bKyjGnafZ19DwC0-IxXUBJzOdAo-cNmhabwhKLxcos,20585
 bbstrader/metatrader/risk.py,sha256=pwG4q1_uPGgPlokDGVNtd04O6p28yIbgT-evvHuo-Qc,27029
 bbstrader/metatrader/scripts.py,sha256=Yjp7Un-wDTInptHS_rPFpXNKWbVM871VEkaHxsO2MPQ,2115
-bbstrader/metatrader/trade.py,sha256=2vkoe972OUi5m5rVkWa2DuyXSo04JCSsF5tyahDbL3s,79926
+bbstrader/metatrader/trade.py,sha256=uDlYCHqXk4AB0Nx8CHQfYUj4OODhm7W39es0r6Yuc8Q,79922
 bbstrader/metatrader/utils.py,sha256=szORxKJW9OG-H6nof_ovOhToSx_n8EtVwe0mkLt3eFg,17424
 bbstrader/models/__init__.py,sha256=s2mJrtKePXQaw_PvcrtPCD2mPCdVXP4Myzg0MlLVipo,547
 bbstrader/models/factors.py,sha256=-ODeD2GK4nmxFQAIh5MF3SFM9ofppi2pW6Q728LzLv8,12701
 bbstrader/models/ml.py,sha256=tCr7YyODl0CDoOUpYqJ1q12ls86Sc-_Fu3b2Y0Z7TJ8,47551
-bbstrader/models/nlp.py,sha256=P7SYaTIqEBldjwYfS6IrO66Y6-ioDXUrCSf3bZxQrDE,28073
+bbstrader/models/nlp.py,sha256=eN4VnexOt1intfX1T-GkaReqBoWPjoqRSWjXIa67ib8,28385
 bbstrader/models/optimization.py,sha256=vnks6uxFZdqXgxaZJNxq8z0IH45KZ8yaXo38JhIVKGc,6399
 bbstrader/models/portfolio.py,sha256=r-47Zrn2r7iKCHm5YVtwkbBJXAZGM3QYy-rXCWY9-Bg,8079
 bbstrader/models/risk.py,sha256=JQOXPshMOru6Eb0AMU6oKCNzg6mlGfL6_tN90lWcVBE,14878
@@ -38,9 +39,9 @@ bbstrader/trading/execution.py,sha256=ukOiv1O-a_SdKp35QlU_3_Wt_7CTgh4pLPN9s7qPEd
 bbstrader/trading/scripts.py,sha256=Tf5q33WqqygjpIv43_8nA82VZ3GM0qgb4Ggo3fHJ_wg,5744
 bbstrader/trading/strategies.py,sha256=rRNPZM1Z9twzO5UWd5qI3FgkZmOhF3Dd2h7XRn7EoDs,37011
 bbstrader/trading/utils.py,sha256=57dKF9dcRu04oU2VRqydRrzW39dCW2wlDWhVt-sZdRw,1857
-bbstrader-0.2.99.dist-info/licenses/LICENSE,sha256=ZwC_RqqGmOPBUiMDKqLyJZ5HBeHq53LpL7TMRzrJY8c,1094
-bbstrader-0.2.99.dist-info/METADATA,sha256=8JnFfL70KEiiqXvBhDEoqafZ4-KMTNtbheytb3-5HZ4,11508
-bbstrader-0.2.99.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-bbstrader-0.2.99.dist-info/entry_points.txt,sha256=0yDCbhbgHswOzJnY5wRSM_FjjyMHGvY7lJpSSVh0xtI,54
-bbstrader-0.2.99.dist-info/top_level.txt,sha256=Wwj322jZmxGZ6gD_TdaPiPLjED5ReObm5omerwlmZIg,10
-bbstrader-0.2.99.dist-info/RECORD,,
+bbstrader-0.2.991.dist-info/licenses/LICENSE,sha256=ZwC_RqqGmOPBUiMDKqLyJZ5HBeHq53LpL7TMRzrJY8c,1094
+bbstrader-0.2.991.dist-info/METADATA,sha256=p3lY0rHksdL6iOhw5Qunyyn_vWPQc8b5CQKrP3mErnM,11411
+bbstrader-0.2.991.dist-info/WHEEL,sha256=GHB6lJx2juba1wDgXDNlMTyM13ckjBMKf-OnwgKOCtA,91
+bbstrader-0.2.991.dist-info/entry_points.txt,sha256=0yDCbhbgHswOzJnY5wRSM_FjjyMHGvY7lJpSSVh0xtI,54
+bbstrader-0.2.991.dist-info/top_level.txt,sha256=Wwj322jZmxGZ6gD_TdaPiPLjED5ReObm5omerwlmZIg,10
+bbstrader-0.2.991.dist-info/RECORD,,

{bbstrader-0.2.99.dist-info → bbstrader-0.2.991.dist-info}/WHEEL

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