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

{wiz_trader-0.40.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.40.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
@@ -2876,10 +3067,87 @@ simple_return = client.get_simple_return(
 )
 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**: 43+ 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.40.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
@@ -2849,10 +3040,87 @@ simple_return = client.get_simple_return(
 )
 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**: 43+ 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.40.0 → wiz_trader-0.41.0}/pyproject.toml

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

{wiz_trader-0.40.0 → wiz_trader-0.41.0}/src/wiz_trader/__init__.py

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

{wiz_trader-0.40.0 → wiz_trader-0.41.0}/src/wiz_trader/apis/client.py

@@ -291,6 +291,10 @@ class WizzerClient:
     "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",
     
   }
   
@@ -4060,3 +4064,215 @@ class WizzerClient:
     
     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-0.40.0 → wiz_trader-0.41.0}/src/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.40.0 → wiz_trader-0.41.0/src/wiz_trader.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wiz_trader
-Version: 0.40.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
@@ -2876,10 +3067,87 @@ simple_return = client.get_simple_return(
 )
 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**: 43+ 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