bw-essentials-core 0.0.8__py3-none-any.whl → 0.0.9__py3-none-any.whl

bw_essentials/services/market_pricer.py

@@ -67,7 +67,8 @@ class MarketPricer(ApiClient):
         self.name = Services.MARKET_PRICER.value
         self.urls = {
             "live": "live",
-            "eod": "eod"
+            "eod": "eod",
+            "index_performance": "index/{}/performance",
         }
 
     def get_live_prices(self, securities, exchange):
@@ -231,3 +232,71 @@ class MarketPricer(ApiClient):
 
         logger.info(f"{market_pricing_eod_response=}")
         return market_pricing_eod_response.get("data")
+
+    def get_index_performance_by_dates(self, index_name, start_date, end_date):
+        """
+        Fetches index performance metrics over a given date range.
+
+        Args:
+            index_name (str): The index name (e.g., "NIFTY50").
+            start_date (str): The start date for performance metrics in 'YYYY-MM-DD' format.
+            end_date (str): The end date for performance metrics in 'YYYY-MM-DD' format.
+
+        Returns:
+            dict: A dictionary containing cumulative return, volatility, drawdown, and a list
+                  of daily return data.
+                  Example:
+                    {
+                      "data": {
+                        "cumulative_return": 2.332968692796598,
+                        "volatility": 6.378354401960588,
+                        "drawdown": 0,
+                        "daily_returns": [
+                          {
+                            "date": "2025-06-05",
+                            "close": 22934.5,
+                            "daily_return": 0.5552912703301827,
+                            "current_weight": 100.55529127033019
+                          },
+                          {
+                            "date": "2025-06-06",
+                            "close": 23165.1,
+                            "daily_return": 1.0054721053434745,
+                            "current_weight": 101.56634667450024
+                          },
+                          {
+                            "date": "2025-06-09",
+                            "close": 23329.4,
+                            "daily_return": 0.7092565972087517,
+                            "current_weight": 102.28671268883305
+                          },
+                          {
+                            "date": "2025-06-10",
+                            "close": 23339.95,
+                            "daily_return": 0.04522190883606836,
+                            "current_weight": 102.3329686927966
+                          }
+                        ]
+                      },
+                      "success": true
+                    }
+        Raises:
+            ValueError: If input parameters are missing or invalid.
+        """
+        logger.info(f"In - get_index_performance_by_dates | {index_name=}, {start_date=}, {end_date=}")
+
+        if not all([index_name, start_date, end_date]):
+            logger.error("Missing required parameters for index performance fetch")
+            raise ValueError("index_name, start_date, and end_date are required")
+
+        endpoint = self.urls['index_performance'].format(index_name)
+        params = {"start_date": start_date, "end_date": end_date}
+        response = self._get(
+            url=self.base_url,
+            endpoint=endpoint,
+            params=params
+        )
+        logger.debug(f"Raw response from MarketPricer index API: {response}")
+        data = response.get("data")
+        logger.info("Out - get_index_performance_by_dates success")
+        return data

{bw_essentials_core-0.0.8.dist-info → bw_essentials_core-0.0.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: bw-essentials-core
-Version: 0.0.8
+Version: 0.0.9
 Summary: Reusable utilities for S3, email, Data Loch, Microsoft Teams Notifications and more.
 Author: InvestorAI
 Author-email: support+tech@investorai.in

{bw_essentials_core-0.0.8.dist-info → bw_essentials_core-0.0.9.dist-info}/RECORD

@@ -13,13 +13,13 @@ bw_essentials/s3_utils/s3_utils.py,sha256=wzjVrTX22_8PMX86svKFYGMZwgjBHbOaeEsxO-
 bw_essentials/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 bw_essentials/services/api_client.py,sha256=74tKxhY_HiVCN3kgtk27a4GNznMaRphAspt9CWecuiY,7793
 bw_essentials/services/broker.py,sha256=As-VT1MxkCD9p-13dQJDwf0_aEJVA6H0wNqL-EYHO4g,8718
-bw_essentials/services/market_pricer.py,sha256=WAFcG5JfnqWxjzXRPrMdovPuKqWJIwa3ENvGAyEyjeM,8712
+bw_essentials/services/market_pricer.py,sha256=Qc9lxzAjhefAvjyEKsBPDu60bF6_61cnSpZNfjGMyDg,11755
 bw_essentials/services/master_data.py,sha256=2o_r2gdhIKBeTFgn5IIY-becgCEpYBymO4BKmixdV1g,11987
 bw_essentials/services/model_portfolio_reporting.py,sha256=iOtm4gyfU8P7C0R1gp6gUJI4ZRxJD5K2GLOalI_gToM,3249
 bw_essentials/services/trade_placement.py,sha256=PrzeU2XXC9HF1IQ1dMDM_ZHxmC491sOl-JbA6GWPwII,20772
 bw_essentials/services/user_portfolio.py,sha256=_5M6yPfQt4MXedINBawEoPkb_o7IGzxPeHkvZkoQm8k,16191
 bw_essentials/services/user_portfolio_reporting.py,sha256=QaZzcw912Uos5ZafEaxLXDmCyetTFiVX3at3cTAv6MA,6003
-bw_essentials_core-0.0.8.dist-info/METADATA,sha256=GHHKudJ8VIoZ0nOUAeAnpQy0FYXXuPMSTQYA_aa3Wt0,7501
-bw_essentials_core-0.0.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-bw_essentials_core-0.0.8.dist-info/top_level.txt,sha256=gDc5T_y5snwKGXDQUusEus-FEt0RFwG644Yn_58wQOQ,14
-bw_essentials_core-0.0.8.dist-info/RECORD,,
+bw_essentials_core-0.0.9.dist-info/METADATA,sha256=NZGAHCPsiUsVhqn8lQnMqdbHSQfTLb0SU_txe_t75B8,7501
+bw_essentials_core-0.0.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+bw_essentials_core-0.0.9.dist-info/top_level.txt,sha256=gDc5T_y5snwKGXDQUusEus-FEt0RFwG644Yn_58wQOQ,14
+bw_essentials_core-0.0.9.dist-info/RECORD,,