wiz-trader 0.20.0__tar.gz → 0.22.0__tar.gz

{wiz_trader-0.20.0/src/wiz_trader.egg-info → wiz_trader-0.22.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wiz_trader
-Version: 0.20.0
+Version: 0.22.0
 Summary: A Python SDK for connecting to the Wizzer.
 Home-page: https://bitbucket.org/wizzer-tech/quotes_sdk.git
 Author: Pawan Wagh
@@ -1628,6 +1628,58 @@ def visualize_option_chain(identifier, expiry):
 visualize_option_chain("NSE:NIFTY 50:26000", "2025-05-30")
 ```
 
+#### Get Futures List
+
+Fetch available futures contracts for an instrument:
+
+```python
+# Get futures for an equity stock
+sbin_futures = client.get_futures_list("NSE:SBIN:3045")
+print(f"Found {len(sbin_futures)} futures contracts for SBIN")
+for future in sbin_futures:
+    print(f"{future['tradingSymbol']} - Expiry: {future['expiry']} ({future['contract']})")
+
+# Get futures for an index
+nifty_futures = client.get_futures_list("NSE:NIFTY 50:26000")
+print(f"Found {len(nifty_futures)} futures contracts for NIFTY 50")
+for future in nifty_futures:
+    print(f"{future['tradingSymbol']} - Expiry: {future['expiry']} ({future['contract']})")
+```
+
+#### Response Structure for Futures List
+
+The `get_futures_list` method returns a list of dictionaries, each representing a futures contract:
+
+```python
+[
+    {
+        # Exchange where the future is traded
+        "exchange": "NSE",
+        
+        # Trading symbol of the futures contract
+        "tradingSymbol": "SBIN25MAYFUT",
+        
+        # Exchange token for the futures contract
+        "exchangeToken": 57515,
+        
+        # Complete identifier for the futures contract
+        "identifier": "NSE:SBIN25MAYFUT:57515",
+        
+        # Expiry date in YYYY-MM-DD format
+        "expiry": "2025-05-29",
+        
+        # Contract type (near_month, mid_month, far_month)
+        "contract": "near_month"
+    },
+    # Additional futures contracts...
+]
+```
+
+The `contract` field indicates the type of futures contract:
+- **`near_month`**: Current month's futures contract
+- **`mid_month`**: Next month's futures contract  
+- **`far_month`**: Month after next futures contract
+
 ### Wizzer Client Examples
 
 #### Market Data and Analysis Example

{wiz_trader-0.20.0 → wiz_trader-0.22.0}/README.md

@@ -1601,6 +1601,58 @@ def visualize_option_chain(identifier, expiry):
 visualize_option_chain("NSE:NIFTY 50:26000", "2025-05-30")
 ```
 
+#### Get Futures List
+
+Fetch available futures contracts for an instrument:
+
+```python
+# Get futures for an equity stock
+sbin_futures = client.get_futures_list("NSE:SBIN:3045")
+print(f"Found {len(sbin_futures)} futures contracts for SBIN")
+for future in sbin_futures:
+    print(f"{future['tradingSymbol']} - Expiry: {future['expiry']} ({future['contract']})")
+
+# Get futures for an index
+nifty_futures = client.get_futures_list("NSE:NIFTY 50:26000")
+print(f"Found {len(nifty_futures)} futures contracts for NIFTY 50")
+for future in nifty_futures:
+    print(f"{future['tradingSymbol']} - Expiry: {future['expiry']} ({future['contract']})")
+```
+
+#### Response Structure for Futures List
+
+The `get_futures_list` method returns a list of dictionaries, each representing a futures contract:
+
+```python
+[
+    {
+        # Exchange where the future is traded
+        "exchange": "NSE",
+        
+        # Trading symbol of the futures contract
+        "tradingSymbol": "SBIN25MAYFUT",
+        
+        # Exchange token for the futures contract
+        "exchangeToken": 57515,
+        
+        # Complete identifier for the futures contract
+        "identifier": "NSE:SBIN25MAYFUT:57515",
+        
+        # Expiry date in YYYY-MM-DD format
+        "expiry": "2025-05-29",
+        
+        # Contract type (near_month, mid_month, far_month)
+        "contract": "near_month"
+    },
+    # Additional futures contracts...
+]
+```
+
+The `contract` field indicates the type of futures contract:
+- **`near_month`**: Current month's futures contract
+- **`mid_month`**: Next month's futures contract  
+- **`far_month`**: Month after next futures contract
+
 ### Wizzer Client Examples
 
 #### Market Data and Analysis Example

{wiz_trader-0.20.0 → wiz_trader-0.22.0}/pyproject.toml

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

{wiz_trader-0.20.0 → wiz_trader-0.22.0}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
   name='wiz_trader',
-  version='0.20.0',
+  version='0.22.0',
   description='A Python SDK for connecting to the Wizzer.',
   long_description=open('README.md').read() if open('README.md') else "",
   long_description_content_type='text/markdown',

{wiz_trader-0.20.0 → wiz_trader-0.22.0}/src/wiz_trader/__init__.py

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

{wiz_trader-0.20.0 → wiz_trader-0.22.0}/src/wiz_trader/quotes/client.py

@@ -193,6 +193,38 @@ class QuotesClient:
             asyncio.set_event_loop(loop)
         loop.create_task(self._subscribe_async(instruments))
 
+    async def _unsubscribe_async(self, instruments: List[str]) -> None:
+        """
+        Internal async unsubscription. Use `unsubscribe()` wrapper to schedule this.
+        """
+        # Only send unsubs if the socket is open
+        if self.ws and self.ws.state == State.OPEN:
+            to_remove = set(instruments) & self.subscribed_instruments
+            if to_remove:
+                for batch in self._chunk_list(list(to_remove), self.batch_size):
+                    logger.info("Unsubscribing from %d instruments", len(batch))
+                    await self.ws.send(json.dumps({
+                        "action": self.ACTION_UNSUBSCRIBE,
+                        "instruments": batch
+                    }))
+                    await asyncio.sleep(0.1)
+                # remove them from our local set
+                self.subscribed_instruments -= to_remove
+        else:
+            # if we're not connected yet, just remove from the queue
+            self.subscribed_instruments -= set(instruments)
+
+    def unsubscribe(self, instruments: List[str]) -> None:
+        """
+        Schedule an async unsubscribe so users can call this without 'await'.
+        """
+        try:
+            loop = asyncio.get_event_loop()
+        except RuntimeError:
+            loop = asyncio.new_event_loop()
+            asyncio.set_event_loop(loop)
+        loop.create_task(self._unsubscribe_async(instruments))
+    
     # You could add a similar unsubscribe wrapper if needed
 
     async def close(self) -> None:

{wiz_trader-0.20.0 → wiz_trader-0.22.0/src/wiz_trader.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wiz_trader
-Version: 0.20.0
+Version: 0.22.0
 Summary: A Python SDK for connecting to the Wizzer.
 Home-page: https://bitbucket.org/wizzer-tech/quotes_sdk.git
 Author: Pawan Wagh
@@ -1628,6 +1628,58 @@ def visualize_option_chain(identifier, expiry):
 visualize_option_chain("NSE:NIFTY 50:26000", "2025-05-30")
 ```
 
+#### Get Futures List
+
+Fetch available futures contracts for an instrument:
+
+```python
+# Get futures for an equity stock
+sbin_futures = client.get_futures_list("NSE:SBIN:3045")
+print(f"Found {len(sbin_futures)} futures contracts for SBIN")
+for future in sbin_futures:
+    print(f"{future['tradingSymbol']} - Expiry: {future['expiry']} ({future['contract']})")
+
+# Get futures for an index
+nifty_futures = client.get_futures_list("NSE:NIFTY 50:26000")
+print(f"Found {len(nifty_futures)} futures contracts for NIFTY 50")
+for future in nifty_futures:
+    print(f"{future['tradingSymbol']} - Expiry: {future['expiry']} ({future['contract']})")
+```
+
+#### Response Structure for Futures List
+
+The `get_futures_list` method returns a list of dictionaries, each representing a futures contract:
+
+```python
+[
+    {
+        # Exchange where the future is traded
+        "exchange": "NSE",
+        
+        # Trading symbol of the futures contract
+        "tradingSymbol": "SBIN25MAYFUT",
+        
+        # Exchange token for the futures contract
+        "exchangeToken": 57515,
+        
+        # Complete identifier for the futures contract
+        "identifier": "NSE:SBIN25MAYFUT:57515",
+        
+        # Expiry date in YYYY-MM-DD format
+        "expiry": "2025-05-29",
+        
+        # Contract type (near_month, mid_month, far_month)
+        "contract": "near_month"
+    },
+    # Additional futures contracts...
+]
+```
+
+The `contract` field indicates the type of futures contract:
+- **`near_month`**: Current month's futures contract
+- **`mid_month`**: Next month's futures contract  
+- **`far_month`**: Month after next futures contract
+
 ### Wizzer Client Examples
 
 #### Market Data and Analysis Example