wiz-trader 0.39.0__tar.gz → 0.41.0__tar.gz

{wiz_trader-0.39.0/src/wiz_trader.egg-info → wiz_trader-0.41.0}/PKG-INFO

@@ -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.39.0 → wiz_trader-0.41.0}/README.md

@@ -12,6 +12,7 @@
     - [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)
@@ -569,6 +570,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
@@ -2807,10 +2998,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.39.0 → wiz_trader-0.41.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "wiz_trader"
-version = "0.39.0"
+version = "0.41.0"
 description = "A Python SDK for connecting to the Wizzer."
 readme = "README.md"
 authors = [