wiz-trader 0.39.0__py3-none-any.whl → 0.41.0__py3-none-any.whl

wiz_trader/__init__.py

@@ -3,6 +3,6 @@
 from .quotes import QuotesClient
 from .apis import WizzerClient
 
-__version__ = "0.39.0"
+__version__ = "0.41.0"
 
 __all__ = ["QuotesClient", "WizzerClient"]

wiz_trader/apis/client.py

@@ -282,11 +282,19 @@ class WizzerClient:
     "analytics.marketdata.average_volume": "/analytics/marketdata/averageVolume",
     "analytics.index.max_drawdown": "/analytics/index/metrics/maxDrawdown",
     "analytics.instrument.drawdown_duration": "/analytics/instrument/metrics/drawdownDuration",
-    "analytics.price.rolling_peak": "/analytics/analytics/price/rollingPeak",
-    "analytics.price.rolling_mean": "/analytics/analytics/price/rollingMean",
-    "analytics.volatility.realized": "/analytics/analytics/volatility/realized",
+    "analytics.price.rolling_peak": "/analytics/price/rollingPeak",
+    "analytics.price.rolling_mean": "/analytics/price/rollingMean",
+    "analytics.volatility.realized": "/analytics/volatility/realized",
     "analytics.risk.beta_90d": "/analytics/risk/beta90d",
     "analytics.risk.beta_custom": "/analytics/risk/beta",
+    "analytics.strategy.drawdown_max": "/analytics/strategy/drawdown/max",
+    "analytics.product.drawdown_max": "/analytics/product/drawdown/max",
+    "analytics.volatility.atr": "/analytics/volatility/atr",
+    "analytics.returns.simple": "/analytics/returns/simple",
+    "analytics.corporate.actions.events": "/analytics/corporate/actions/events",
+    "analytics.corporate.actions.filter": "/analytics/corporate/actions/filter",
+    "analytics.corporate.announcements.events": "/analytics/corporate/announcements/events",
+    "analytics.corporate.announcements.filter": "/analytics/corporate/announcements/filter",
     
   }
   
@@ -3875,3 +3883,396 @@ class WizzerClient:
     
     logger.debug("Fetching custom period beta for %s vs %s from %s to %s", symbol, benchmark, start_date, end_date)
     return self._make_request("GET", self._routes["analytics.risk.beta_custom"], params=params)
+
+  def get_strategy_max_drawdown(
+    self, 
+    strategy_id: str, 
+    start_date: str, 
+    end_date: str, 
+    interval: str = "daily"
+  ) -> Dict[str, Any]:
+    """
+    Get maximum drawdown for a strategy over a specified period.
+    
+    Args:
+      strategy_id (str): Strategy identifier.
+      start_date (str): Start date (YYYY-MM-DD).
+      end_date (str): End date (YYYY-MM-DD).
+      interval (str): Time interval ('daily', 'weekly', 'monthly').
+      
+    Returns:
+      Dict[str, Any]: Strategy max drawdown data.
+      
+    Example Response:
+      {
+        "strategyId": "str_01jspb8z36edjsp5pecqq0mpm3",
+        "startDate": "2023-01-01",
+        "endDate": "2024-12-31",
+        "maxDrawdown": -0.15,
+        "peakDate": "2023-06-15",
+        "troughDate": "2023-09-20",
+        "peakNav": 1.25,
+        "troughNav": 1.06
+      }
+    """
+    params = self._normalize_params({
+      "strategyId": strategy_id,
+      "startDate": start_date,
+      "endDate": end_date,
+      "interval": interval
+    })
+    
+    logger.debug("Fetching max drawdown for strategy %s from %s to %s", strategy_id, start_date, end_date)
+    return self._make_request("GET", self._routes["analytics.strategy.drawdown_max"], params=params)
+
+  def get_product_max_drawdown(
+    self, 
+    product_id: str, 
+    start_date: str, 
+    end_date: str, 
+    interval: str = "daily"
+  ) -> Dict[str, Any]:
+    """
+    Get maximum drawdown for a product over a specified period.
+    
+    Args:
+      product_id (str): Product identifier.
+      start_date (str): Start date (YYYY-MM-DD).
+      end_date (str): End date (YYYY-MM-DD).
+      interval (str): Time interval ('daily', 'weekly', 'monthly').
+      
+    Returns:
+      Dict[str, Any]: Product max drawdown data.
+      
+    Example Response:
+      {
+        "productId": "prd_01jyrg7ffkemq9hz3rkeznh9dr",
+        "startDate": "2023-01-01",
+        "endDate": "2024-12-31",
+        "maxDrawdown": -0.12,
+        "peakDate": "2023-05-10",
+        "troughDate": "2023-08-15",
+        "peakNav": 1.18,
+        "troughNav": 1.04
+      }
+    """
+    params = self._normalize_params({
+      "productId": product_id,
+      "startDate": start_date,
+      "endDate": end_date,
+      "interval": interval
+    })
+    
+    logger.debug("Fetching max drawdown for product %s from %s to %s", product_id, start_date, end_date)
+    return self._make_request("GET", self._routes["analytics.product.drawdown_max"], params=params)
+
+  def get_atr(
+    self, 
+    symbol: str, 
+    start_date: str, 
+    end_date: str, 
+    window: int, 
+    adjusted: bool = True, 
+    interval: str = "daily"
+  ) -> Dict[str, Any]:
+    """
+    Calculate Average True Range (ATR) for a security over a specified period.
+    
+    Args:
+      symbol (str): Stock symbol.
+      start_date (str): Start date (YYYY-MM-DD).
+      end_date (str): End date (YYYY-MM-DD).
+      window (int): Lookback period (e.g., 14, 20).
+      adjusted (bool): Adjust for splits/dividends.
+      interval (str): Time interval ('daily', 'weekly', 'intraday').
+      
+    Returns:
+      Dict[str, Any]: ATR data.
+      
+    Example Response:
+      {
+        "symbol": "AXISBANK",
+        "startDate": "2023-01-01",
+        "endDate": "2024-12-31",
+        "window": 14,
+        "adjusted": true,
+        "atr": [
+          {
+            "date": "2023-01-15",
+            "atrValue": 25.67
+          }
+        ]
+      }
+    """
+    params = self._normalize_params({
+      "symbol": symbol,
+      "startDate": start_date,
+      "endDate": end_date,
+      "window": window,
+      "adjusted": adjusted,
+      "interval": interval
+    })
+    
+    logger.debug("Fetching ATR for %s with window %d from %s to %s", symbol, window, start_date, end_date)
+    return self._make_request("GET", self._routes["analytics.volatility.atr"], params=params)
+
+  def get_simple_return(
+    self, 
+    symbol: str, 
+    start_date: str, 
+    end_date: str, 
+    adjusted: bool = True, 
+    interval: str = "daily", 
+    benchmark: Optional[str] = None
+  ) -> Dict[str, Any]:
+    """
+    Calculate simple return for a security or sectoral index.
+    
+    Args:
+      symbol (str): Stock/index symbol.
+      start_date (str): Start date (YYYY-MM-DD).
+      end_date (str): End date (YYYY-MM-DD).
+      adjusted (bool): Adjust for corporate actions.
+      interval (str): Time interval ('daily', 'weekly', 'monthly').
+      benchmark (str, optional): Benchmark for relative return calculation.
+      
+    Returns:
+      Dict[str, Any]: Simple return data.
+      
+    Example Response:
+      {
+        "symbol": "NIFTY IT",
+        "startDate": "2023-01-01",
+        "endDate": "2024-12-31",
+        "adjusted": true,
+        "totalReturn": 0.15,
+        "startPrice": 1250.0,
+        "endPrice": 1437.5,
+        "benchmarkReturn": 0.12,
+        "relativeReturn": 0.03,
+        "unit": "decimal"
+      }
+    """
+    params = self._normalize_params({
+      "symbol": symbol,
+      "startDate": start_date,
+      "endDate": end_date,
+      "adjusted": adjusted,
+      "interval": interval,
+      "benchmark": benchmark
+    })
+    
+    logger.debug("Fetching simple return for %s from %s to %s", symbol, start_date, end_date)
+    return self._make_request("GET", self._routes["analytics.returns.simple"], params=params)
+
+  def get_corporate_actions_events(self) -> List[str]:
+    """
+    Get all available corporate action event types.
+    
+    Returns:
+      List[str]: List of available corporate action event types.
+      
+    Example Response:
+      [
+        "AGM",
+        "BONUS",
+        "DIVIDEND",
+        "SPLIT",
+        "RIGHTS",
+        "BUYBACK"
+      ]
+    """
+    logger.debug("Fetching corporate actions events")
+    return self._make_request("GET", self._routes["analytics.corporate.actions.events"])
+
+  def get_corporate_actions_filter(
+    self, 
+    symbol: Optional[str] = None, 
+    events: Optional[str] = None, 
+    actionCategory: Optional[str] = None, 
+    fromDate: Optional[str] = None, 
+    toDate: Optional[str] = None, 
+    exchange: Optional[str] = None, 
+    hasDividend: Optional[bool] = None, 
+    hasBonus: Optional[bool] = None, 
+    hasAgm: Optional[bool] = None, 
+    eventTextContains: Optional[str] = None, 
+    faceValue: Optional[float] = None, 
+    ratioNumerator: Optional[int] = None, 
+    ratioDenominator: Optional[int] = None, 
+    actionSubcategory: Optional[str] = None, 
+    primaryAmount: Optional[float] = None, 
+    secondaryAmount: Optional[float] = None, 
+    oldFaceValue: Optional[float] = None, 
+    newFaceValue: Optional[float] = None, 
+    page: int = 1, 
+    pageSize: int = 20
+  ) -> Dict[str, Any]:
+    """
+    Filter corporate actions based on various criteria with pagination support.
+    
+    Args:
+      symbol (str, optional): Trading symbol to filter by.
+      events (str, optional): Event type to filter by.
+      actionCategory (str, optional): Action category to filter by.
+      fromDate (str, optional): Ex-date from (YYYY-MM-DD).
+      toDate (str, optional): Ex-date to (YYYY-MM-DD).
+      exchange (str, optional): Exchange to filter by.
+      hasDividend (bool, optional): Filter for dividend actions.
+      hasBonus (bool, optional): Filter for bonus actions.
+      hasAgm (bool, optional): Filter for AGM actions.
+      eventTextContains (str, optional): Search text within event description.
+      faceValue (float, optional): Face value to filter by.
+      ratioNumerator (int, optional): Ratio numerator value.
+      ratioDenominator (int, optional): Ratio denominator value.
+      actionSubcategory (str, optional): Action subcategory to filter by.
+      primaryAmount (float, optional): Primary amount to filter by.
+      secondaryAmount (float, optional): Secondary amount to filter by.
+      oldFaceValue (float, optional): Old face value to filter by.
+      newFaceValue (float, optional): New face value to filter by.
+      page (int): Page number for pagination (default: 1).
+      pageSize (int): Records per page (default: 20, max: 100).
+      
+    Returns:
+      Dict[str, Any]: Filtered corporate actions data with pagination.
+      
+    Example Response:
+      {
+        "data": [
+          {
+            "tradingSymbol": "RELIANCE",
+            "faceValue": 10.0,
+            "eventText": "Reliance Industries Limited has declared dividend",
+            "exDate": "15-03-2024",
+            "recDate": "16-03-2024",
+            "events": "Dividend",
+            "exchange": "NSE",
+            "actionCategory": "DIVIDEND",
+            "actionSubcategory": "INTERIM",
+            "primaryAmount": 8.5,
+            "hasDividend": true,
+            "hasBonus": false,
+            "hasAgm": false
+          }
+        ],
+        "totalCount": 150,
+        "page": 1,
+        "pageSize": 20
+      }
+    """
+    params = self._normalize_params({
+      "symbol": symbol,
+      "events": events,
+      "actionCategory": actionCategory,
+      "fromDate": fromDate,
+      "toDate": toDate,
+      "exchange": exchange,
+      "hasDividend": hasDividend,
+      "hasBonus": hasBonus,
+      "hasAgm": hasAgm,
+      "eventTextContains": eventTextContains,
+      "faceValue": faceValue,
+      "ratioNumerator": ratioNumerator,
+      "ratioDenominator": ratioDenominator,
+      "actionSubcategory": actionSubcategory,
+      "primaryAmount": primaryAmount,
+      "secondaryAmount": secondaryAmount,
+      "oldFaceValue": oldFaceValue,
+      "newFaceValue": newFaceValue,
+      "page": page,
+      "pageSize": pageSize
+    })
+    
+    logger.debug("Filtering corporate actions with %d parameters", len([p for p in params.values() if p is not None]))
+    return self._make_request("GET", self._routes["analytics.corporate.actions.filter"], params=params)
+
+  def get_corporate_announcements_events(self) -> List[str]:
+    """
+    Get all available corporate announcement event types.
+    
+    Returns:
+      List[str]: List of available corporate announcement event types.
+      
+    Example Response:
+      [
+        "AGM / Book Closure",
+        "Results Update",
+        "Board Meeting",
+        "Financial Results",
+        "Dividend Declaration",
+        "Merger/Acquisition"
+      ]
+    """
+    logger.debug("Fetching corporate announcements events")
+    return self._make_request("GET", self._routes["analytics.corporate.announcements.events"])
+
+  def get_corporate_announcements_filter(
+    self, 
+    symbol: Optional[str] = None, 
+    events: Optional[str] = None, 
+    fromDate: Optional[str] = None, 
+    toDate: Optional[str] = None, 
+    announcementDateFrom: Optional[str] = None, 
+    announcementDateTo: Optional[str] = None, 
+    exchange: Optional[str] = None, 
+    announcementContains: Optional[str] = None, 
+    hasXbrl: Optional[bool] = None, 
+    page: int = 1, 
+    pageSize: int = 20
+  ) -> Dict[str, Any]:
+    """
+    Filter corporate announcements based on various criteria with pagination support.
+    
+    Args:
+      symbol (str, optional): Trading symbol to filter by.
+      events (str, optional): Event type to filter by.
+      fromDate (str, optional): Date from (YYYY-MM-DD).
+      toDate (str, optional): Date to (YYYY-MM-DD).
+      announcementfromDate(str, optional): Announcement date from (YYYY-MM-DD).
+      announcementDateTo (str, optional): Announcement date to (YYYY-MM-DD).
+      exchange (str, optional): Exchange to filter by.
+      announcementContains (str, optional): Search text within announcement.
+      hasXbrl (bool, optional): Filter for announcements with XBRL.
+      page (int): Page number for pagination (default: 1).
+      pageSize (int): Records per page (default: 20, max: 100).
+      
+    Returns:
+      Dict[str, Any]: Filtered corporate announcements data with pagination.
+      
+    Example Response:
+      {
+        "data": [
+          {
+            "tradingSymbol": "FINCABLES",
+            "events": "AGM",
+            "date": "30-04-2010",
+            "companyName": "Finolex Cables Limited",
+            "announcementDate": "30-04-2010",
+            "sortDate": "30-04-2010",
+            "announcement": "Finolex Cables Limited has informed the Exchange...",
+            "exchange": "NSE",
+            "attachmentFile": "-",
+            "industry": "Cables - Power"
+          }
+        ],
+        "totalCount": 250,
+        "page": 1,
+        "pageSize": 20
+      }
+    """
+    params = self._normalize_params({
+      "symbol": symbol,
+      "events": events,
+      "fromDate": fromDate,
+      "toDate": toDate,
+      "announcementDateFrom": announcementDateFrom,
+      "announcementDateTo": announcementDateTo,
+      "exchange": exchange,
+      "announcementContains": announcementContains,
+      "hasXbrl": hasXbrl,
+      "page": page,
+      "pageSize": pageSize
+    })
+    
+    logger.debug("Filtering corporate announcements with %d parameters", len([p for p in params.values() if p is not None]))
+    return self._make_request("GET", self._routes["analytics.corporate.announcements.filter"], params=params)

wiz_trader/quotes/client.py

@@ -3,7 +3,7 @@ import json
 import os
 import logging
 import random
-from typing import Callable, List, Optional, Any, Iterator
+from typing import Callable, List, Optional, Any, Iterator, Dict
 
 import websockets
 from websockets.exceptions import ConnectionClosed
@@ -17,6 +17,9 @@ if not logger.handlers:
     handler.setFormatter(formatter)
     logger.addHandler(handler)
 
+# Type alias for corporate event callbacks
+CorporateEventCallback = Callable[['QuotesClient', Dict[str, Any]], None]
+
 
 class QuotesClient:
     """
@@ -32,6 +35,8 @@ class QuotesClient:
       on_trade (Callable): Callback for trade events (type='trade').
       on_position (Callable): Callback for position events (type='position').
       on_holding (Callable): Callback for holding events (type='holding').
+      on_corporate_action (Callable): Callback for corporate action events (type='corporateActions').
+      on_corporate_announcement (Callable): Callback for corporate announcement events (type='corporateAnnouncements').
       on_connect (Callable): Callback when connection is established.
       on_close (Callable): Callback when connection is closed.
       on_error (Callable): Callback for errors.
@@ -43,6 +48,8 @@ class QuotesClient:
       - Event messages with type='trade' are routed to on_trade callback
       - Event messages with type='position' are routed to on_position callback
       - Event messages with type='holding' are routed to on_holding callback
+      - Event messages with type='corporateActions' are routed to on_corporate_action callback
+      - Event messages with type='corporateAnnouncements' are routed to on_corporate_announcement callback
       - Messages without type field are routed to on_tick for backward compatibility
       - Messages are silently dropped if the appropriate handler is not registered
     
@@ -118,6 +125,10 @@ class QuotesClient:
         self.on_trade: Optional[Callable[[Any, dict], None]] = None
         self.on_position: Optional[Callable[[Any, dict], None]] = None
         self.on_holding: Optional[Callable[[Any, dict], None]] = None
+        
+        # Corporate event callbacks
+        self.on_corporate_action: Optional[CorporateEventCallback] = None
+        self.on_corporate_announcement: Optional[CorporateEventCallback] = None
 
         logger.debug("Initialized QuotesClient with URL: %s", self.url)
 
@@ -291,6 +302,22 @@ class QuotesClient:
                                         logger.debug("Error in on_holding handler: %s", e)
                                 else:
                                     logger.debug("Received holding event but no on_holding handler registered")
+                            elif message_type == 'corporateActions':
+                                if self.on_corporate_action:
+                                    try:
+                                        self.on_corporate_action(self, data)
+                                    except Exception as e:
+                                        logger.debug("Error in on_corporate_action handler: %s", e)
+                                else:
+                                    logger.debug("Received corporate action event but no on_corporate_action handler registered")
+                            elif message_type == 'corporateAnnouncements':
+                                if self.on_corporate_announcement:
+                                    try:
+                                        self.on_corporate_announcement(self, data)
+                                    except Exception as e:
+                                        logger.debug("Error in on_corporate_announcement handler: %s", e)
+                                else:
+                                    logger.debug("Received corporate announcement event but no on_corporate_announcement handler registered")
                             else:
                                 # No type field - send to on_tick for backward compatibility
                                 if self.on_tick:

{wiz_trader-0.39.0.dist-info → wiz_trader-0.41.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wiz_trader
-Version: 0.39.0
+Version: 0.41.0
 Summary: A Python SDK for connecting to the Wizzer.
 Home-page: https://bitbucket.org/wizzer-tech/quotes_sdk.git
 Author: Pawan Wagh
@@ -39,6 +39,7 @@ Dynamic: requires-python
     - [Subscribing to Instruments](#subscribing-to-instruments)
     - [Unsubscribing from Instruments](#unsubscribing-from-instruments)
     - [Account Events](#account-events)
+    - [Corporate Events](#corporate-events)
     - [Handling WebSocket Connection](#handling-websocket-connection)
     - [Complete Examples](#quotes-client-examples)
 5. [Wizzer Client](#wizzer-client)
@@ -596,6 +597,196 @@ client.on_trade = strategy.on_trade_event
 client.connect()
 ```
 
+### Corporate Events
+
+The QuotesClient supports automatic reception of corporate events from the server. These include corporate actions (dividends, stock splits, bonus issues) and corporate announcements (earnings reports, AGM notices, company announcements).
+
+#### Corporate Event Handlers
+
+```python
+from wiz_trader import QuotesClient
+
+def handle_corporate_action(client, event):
+    """Handle corporate actions like dividends, splits, bonus issues"""
+    print(f"Corporate Action: {event['data']['eventText']}")
+    print(f"Symbol: {event['data']['tradingSymbol']}")
+    print(f"Date: {event['data']['date']}")
+    
+    # Handle specific action categories
+    action_category = event['data'].get('actionCategory', '').lower()
+    if action_category == 'dividend':
+        amount = event['data'].get('primaryAmount')
+        print(f"Dividend Amount: ₹{amount} per share")
+    elif action_category == 'split':
+        print(f"Stock Split - Face Value Change from ₹{event['data'].get('oldFaceValue')} to ₹{event['data'].get('newFaceValue')}")
+    elif action_category == 'bonus':
+        ratio_num = event['data'].get('ratioNumerator')
+        ratio_den = event['data'].get('ratioDenominator')
+        if ratio_num and ratio_den:
+            print(f"Bonus Shares: {ratio_num}:{ratio_den} ratio")
+
+def handle_corporate_announcement(client, event):
+    """Handle corporate announcements like earnings, AGM notices"""
+    print(f"Announcement: {event['data']['announcement']}")
+    print(f"Symbol: {event['data']['tradingSymbol']}")
+    print(f"Date: {event['data']['date']}")
+    print(f"Event Description: {event['data']['eventsDescriptions']}")
+    
+    # Check for attachment file
+    if 'attachmentFile' in event['data']:
+        print(f"Attachment: {event['data']['attachmentFile']}")
+
+# Register corporate event handlers
+client.on_corporate_action = handle_corporate_action
+client.on_corporate_announcement = handle_corporate_announcement
+```
+
+#### Corporate Event Types
+
+**Corporate Actions** (`type: 'events.corporate.actions'`):
+- **Dividends**: Cash dividends, special dividends
+- **Stock Splits**: Forward splits, reverse splits  
+- **Bonus Issues**: Bonus share distributions
+- **Rights Issues**: Rights share offerings
+- **Mergers & Acquisitions**: Corporate restructuring events
+
+**Corporate Announcements** (`type: 'events.corporate.announcements'`):
+- **Earnings Reports**: Quarterly and annual results
+- **AGM/EGM Notices**: Annual and extraordinary general meetings
+- **Board Meetings**: Board meeting announcements
+- **Company Updates**: Material announcements, regulatory filings
+
+#### Example Event Data Structures
+
+**Corporate Action Example**:
+```json
+{
+    "data": {
+        "actionCategory": "dividend",
+        "actionSubcategory": "",
+        "assetClass": "sme",
+        "date": "19-08-2025",
+        "eventText": "DIVIDEND - RS 2 PER SHARE",
+        "events": "corporate_actions.other_corporate_action",
+        "eventsDescriptions": "OTHER CORPORATE ACTION",
+        "faceValue": 10,
+        "hasAgm": false,
+        "hasBonus": false,
+        "hasDividend": true,
+        "newFaceValue": null,
+        "oldFaceValue": null,
+        "percentageValue": null,
+        "primaryAmount": 2,
+        "ratioDenominator": null,
+        "ratioNumerator": null,
+        "secondaryAmount": null,
+        "series": "SM",
+        "tradingSymbol": "SBIN"
+    },
+    "timestamp": "2025-08-19T19:04:47.789Z",
+    "type": "events.corporate.actions"
+}
+```
+
+**Corporate Announcement Example**:
+```json
+{
+    "data": {
+        "announcement": "Manglam Infra & Engineering Limited has informed the Exchange about award of Additional Work from BRO under Project Deepak, Himachal Pradesh.",
+        "assetClass": "sme",
+        "attachmentFile": "https://nsearchives.nseindia.com/corporate/MANGLAMINFRA_19082025133231_addition.pdf",
+        "date": "19-08-2025",
+        "events": "corporate_announcements.general_updates",
+        "eventsDescriptions": "General Updates",
+        "hasXbrl": false,
+        "industry": "",
+        "tradingSymbol": "SBIN"
+    },
+    "timestamp": "2025-08-19T19:04:30.511Z",
+    "type": "events.corporate.announcements"
+}
+```
+
+#### Complete Corporate Events Example
+
+```python
+from wiz_trader import QuotesClient
+from datetime import datetime
+
+# Initialize client
+client = QuotesClient(
+    base_url="url",
+    token="your-jwt-token",
+    log_level="info"
+)
+
+def handle_corporate_action(client, event):
+    """Comprehensive corporate action handler"""
+    print(f"\n🏢 CORPORATE ACTION - {datetime.now()}")
+    data = event.get('data', {})
+    
+    print(f"Symbol: {data.get('tradingSymbol')}")
+    print(f"Action: {data.get('eventText')}")
+    print(f"Date: {data.get('date')}")
+    print(f"Event: {data.get('eventsDescriptions')}")
+    print(f"Asset Class: {data.get('assetClass')}")
+    print(f"Face Value: ₹{data.get('faceValue')}")
+    
+    # Action-specific handling based on actionCategory
+    action_category = data.get('actionCategory', '').lower()
+    if action_category == 'dividend' and data.get('hasDividend'):
+        amount = data.get('primaryAmount')
+        print(f"💰 Dividend: ₹{amount} per share")
+        # Implement dividend tracking logic
+    elif action_category == 'bonus' and data.get('hasBonus'):
+        ratio_num = data.get('ratioNumerator')
+        ratio_den = data.get('ratioDenominator')
+        if ratio_num and ratio_den:
+            print(f"🎁 Bonus Shares: {ratio_num}:{ratio_den} ratio")
+        # Update portfolio for bonus shares
+    elif action_category == 'split':
+        old_fv = data.get('oldFaceValue')
+        new_fv = data.get('newFaceValue')
+        if old_fv and new_fv:
+            print(f"📊 Stock Split: Face value changed from ₹{old_fv} to ₹{new_fv}")
+        # Adjust position quantities
+
+def handle_corporate_announcement(client, event):
+    """Comprehensive corporate announcement handler"""
+    print(f"\n📢 CORPORATE ANNOUNCEMENT - {datetime.now()}")
+    data = event.get('data', {})
+    
+    print(f"Symbol: {data.get('tradingSymbol')}")
+    print(f"Announcement: {data.get('announcement')}")
+    print(f"Date: {data.get('date')}")
+    print(f"Event: {data.get('eventsDescriptions')}")
+    print(f"Asset Class: {data.get('assetClass')}")
+    
+    # Check for attachment file
+    if 'attachmentFile' in data:
+        print(f"📎 Attachment: {data['attachmentFile']}")
+    
+    # Event-specific handling based on events field
+    events = data.get('events', '').lower()
+    if 'earnings' in events or 'results' in events:
+        print("📈 Earnings/Results announcement detected")
+        # Implement earnings analysis
+    elif 'general_updates' in events:
+        print("📋 General company update")
+        # Handle general announcements
+
+# Register handlers
+client.on_corporate_action = handle_corporate_action
+client.on_corporate_announcement = handle_corporate_announcement
+
+# Optional: Subscribe to market data as well
+instruments = ["NSE:RELIANCE-EQ", "NSE:TCS-EQ"]
+client.subscribe(instruments, mode="ticks")
+
+# Start listening for events
+client.connect()
+```
+
 ### Complete Examples
 
 #### Blocking Example
@@ -2834,10 +3025,129 @@ beta_custom = client.get_beta_custom_period(
 )
 print(f"Custom Period Beta: {beta_custom['beta']}")
 print(f"Alpha: {beta_custom['alpha']}")
+
+# Strategy Max Drawdown
+strategy_drawdown = client.get_strategy_max_drawdown(
+    strategy_id="str_01jspb8z36edjsp5pecqq0mpm3",
+    start_date="2023-01-01",
+    end_date="2024-12-31",
+    interval="daily"
+)
+print(f"Strategy Max Drawdown: {strategy_drawdown['maxDrawdown']}")
+print(f"Peak Date: {strategy_drawdown['peakDate']}")
+
+# Product Max Drawdown
+product_drawdown = client.get_product_max_drawdown(
+    product_id="prd_01jyrg7ffkemq9hz3rkeznh9dr",
+    start_date="2023-01-01",
+    end_date="2024-12-31",
+    interval="monthly"
+)
+print(f"Product Max Drawdown: {product_drawdown['maxDrawdown']}")
+
+# Average True Range (ATR)
+atr_data = client.get_atr(
+    symbol="AXISBANK",
+    start_date="2023-01-01",
+    end_date="2024-12-31",
+    window=14,
+    adjusted=True,
+    interval="daily"
+)
+print(f"Latest ATR: {atr_data['atr'][-1]['atrValue']}")
+
+# Simple Return
+simple_return = client.get_simple_return(
+    symbol="NIFTY_IT",
+    start_date="2023-01-01",
+    end_date="2024-12-31",
+    adjusted=True,
+    interval="daily",
+    benchmark="NIFTY 50"
+)
+print(f"Total Return: {simple_return['totalReturn']}")
+print(f"Relative Return: {simple_return['relativeReturn']}")
+
+# Corporate Actions and Announcements
+corporate_events = client.get_corporate_actions_events()
+print(f"Available Corporate Action Types: {corporate_events}")
+
+# Filter Corporate Actions
+corporate_actions = client.get_corporate_actions_filter(
+    symbol="RELIANCE",
+    events="corporate_actions.agm",
+    fromDate="2024-01-01",
+    toDate="2024-12-31",
+    hasDividend=True,
+    page=1,
+    pageSize=20
+)
+print(f"Found {corporate_actions['totalCount']} corporate actions")
+
+# Corporate Announcements
+announcement_events = client.get_corporate_announcements_events()
+print(f"Available Announcement Types: {announcement_events}")
+
+# Filter Corporate Announcements
+announcements = client.get_corporate_announcements_filter(
+    symbol="TCS",
+    events="corporate_announcements.agm",
+    fromDate="2024-01-01",
+    toDate="2024-12-31",
+    announcementContains="dividend",
+    page=1,
+    pageSize=10
+)
+print(f"Found {announcements['totalCount']} announcements")
 ```
 
+### Corporate Analytics API Reference
+
+#### Corporate Actions Filter Parameters
+
+| Parameter | Type | Required | Description | Example |
+|-----------|------|----------|-------------|----------|
+| symbol | string | No | Trading symbol to filter by | RELIANCE, TCS |
+| events | string | No | Event type to filter by | Dividend, BONUS |
+| actionCategory | string | No | Action category to filter by | DIVIDEND, BONUS, SPLIT |
+| fromDate | string (date) | No | Ex-date from (YYYY-MM-DD) | 2024-01-01 |
+| toDate | string (date) | No | Ex-date to (YYYY-MM-DD) | 2024-12-31 |
+| exchange | string | No | Exchange to filter by | NSE, BSE |
+| hasDividend | boolean | No | Filter for dividend actions | true, false |
+| hasBonus | boolean | No | Filter for bonus actions | true, false |
+| hasAgm | boolean | No | Filter for AGM actions | true, false |
+| eventTextContains | string | No | Search text within event description | bonus, dividend |
+| faceValue | number | No | Face value to filter by | 10, 1 |
+| ratioNumerator | integer | No | Ratio numerator value | 1, 2 |
+| ratioDenominator | integer | No | Ratio denominator value | 1, 10 |
+| actionSubcategory | string | No | Action subcategory to filter by | INTERIM, FINAL |
+| primaryAmount | number | No | Primary amount to filter by | 5.50, 10.00 |
+| secondaryAmount | number | No | Secondary amount to filter by | 2.50 |
+| oldFaceValue | number | No | Old face value to filter by | 10 |
+| newFaceValue | number | No | New face value to filter by | 1 |
+| page | integer | No | Page number for pagination (default: 1) | 1, 2 |
+| pageSize | integer | No | Records per page (default: 20, max: 100) | 20, 50 |
+
+#### Corporate Announcements Filter Parameters
+
+| Parameter | Type | Required | Description | Example |
+|-----------|------|----------|-------------|----------|
+| symbol | string | No | Trading symbol to filter by | 20MICRONS, FINCABLES |
+| events | string | No | Event type to filter by | AGM, Results Update |
+| fromDate | string (date) | No | Date from (YYYY-MM-DD) | 2012-01-01 |
+| toDate | string (date) | No | Date to (YYYY-MM-DD) | 2012-12-31 |
+| announcementDateFrom | string (date) | No | Announcement date from (YYYY-MM-DD) | 2010-01-01 |
+| announcementDateTo | string (date) | No | Announcement date to (YYYY-MM-DD) | 2010-12-31 |
+| exchange | string | No | Exchange to filter by | NSE, BSE |
+| announcementContains | string | No | Search text within announcement | dividend, merger |
+| hasXbrl | boolean | No | Filter for announcements with XBRL | true, false |
+| page | integer | No | Page number for pagination (default: 1) | 1, 2 |
+| pageSize | integer | No | Records per page (default: 20, max: 100) | 20, 50 |
+
 **Key Features:**
-- **Comprehensive Coverage**: 39+ analytics endpoints covering fundamentals, valuation, returns, market data, ownership, metrics, macro data, risk analysis, sector classification, leverage analysis, and advanced technical analysis
+- **Comprehensive Coverage**: 47+ analytics endpoints covering fundamentals, valuation, returns, market data, ownership, metrics, macro data, risk analysis, sector classification, leverage analysis, advanced technical analysis, and corporate actions/announcements
+- **Corporate Actions**: Track dividends, bonus issues, stock splits, rights issues, AGMs, and buybacks with comprehensive filtering
+- **Corporate Announcements**: Monitor board meetings, financial results, AGM notifications, and regulatory announcements with XBRL support
 - **Fundamentals Analysis**: 9 methods including ROE, ROA, margins, ratios, book-to-market, market cap-to-sales, and cash-to-market cap
 - **Valuation Metrics**: P/E, P/B, EV/EBITDA, FCF yield with TTM and consolidated/standalone options
 - **Risk-Adjusted Metrics**: Sortino ratio, upside capture ratio, maximum drawdown, and returns volatility for comprehensive risk analysis

wiz_trader-0.41.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+wiz_trader/__init__.py,sha256=VkSBcjg84kJxtyz6qoHYKTlLKYzqXx_41OundOg79MQ,183
+wiz_trader/apis/__init__.py,sha256=6sUr1nzmplNdld0zryMrQSt0jHT2GhOiFYgKKVHzk8U,133
+wiz_trader/apis/client.py,sha256=zSPATxgLM-E_9SrVcpbSthwp4mPrtdXjkvpVeYAbbUw,142151
+wiz_trader/quotes/__init__.py,sha256=RF9g9CNP6bVWlmCh_ad8krm3-EWOIuVfLp0-H9fAeEM,108
+wiz_trader/quotes/client.py,sha256=3m4gGizytyIUtE9BstESjq3o2JnVaCC1m2RnpnG9KqE,22795
+wiz_trader-0.41.0.dist-info/METADATA,sha256=1mJXsH5bCEqy7HC60-ccQV18nfIHED_RABVIMtAAAtU,183434
+wiz_trader-0.41.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+wiz_trader-0.41.0.dist-info/top_level.txt,sha256=lnYS_g8LlA6ryKYnvY8xIQ6K2K-xzOsd-99AWgnW6VY,11
+wiz_trader-0.41.0.dist-info/RECORD,,

wiz_trader-0.39.0.dist-info/RECORD

@@ -1,9 +0,0 @@
-wiz_trader/__init__.py,sha256=tGTxOYvxNnCM60gbqm1vUEVVPSwJenwhzcpX4_UVH6U,183
-wiz_trader/apis/__init__.py,sha256=6sUr1nzmplNdld0zryMrQSt0jHT2GhOiFYgKKVHzk8U,133
-wiz_trader/apis/client.py,sha256=BMjJbh6dgUsfm7rWpmOhzcGRSkSQmk_4WO8ewLN80Jw,128652
-wiz_trader/quotes/__init__.py,sha256=RF9g9CNP6bVWlmCh_ad8krm3-EWOIuVfLp0-H9fAeEM,108
-wiz_trader/quotes/client.py,sha256=cAGaysLCljZilYgX8Sf3V88F6dWlcewJf6TMOpSKb7I,20862
-wiz_trader-0.39.0.dist-info/METADATA,sha256=TZaHzAX7bsObQveYYiN3lCJDyHoCxKGFStajdGk4g8g,171180
-wiz_trader-0.39.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-wiz_trader-0.39.0.dist-info/top_level.txt,sha256=lnYS_g8LlA6ryKYnvY8xIQ6K2K-xzOsd-99AWgnW6VY,11
-wiz_trader-0.39.0.dist-info/RECORD,,