wiz-trader 0.34.0__py3-none-any.whl → 0.36.0__py3-none-any.whl

wiz_trader/__init__.py

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

wiz_trader/apis/client.py

@@ -160,6 +160,13 @@ class WizzerClient:
   WEIGHTAGE_SCHEME_FLOAT_ADJUSTED_MARKET_CAP_WEIGHTED = "float_adjusted_market_cap_weighted"
   WEIGHTAGE_SCHEME_FUNDAMENTAL_WEIGHTED = "fundamental_weighted"
   WEIGHTAGE_SCHEME_CUSTOM_WEIGHTED = "custom_weighted"
+  
+  # KV data type constants
+  KV_TYPE_STRING = "string"
+  KV_TYPE_BOOLEAN = "boolean"
+  KV_TYPE_NUMBER = "number"
+  KV_TYPE_ARRAY = "array"
+  KV_TYPE_OBJECT = "object"
 
   # URIs to various API endpoints
   _routes = {
@@ -209,7 +216,17 @@ class WizzerClient:
     
     # Screener API endpoints
     "screener.run": "/datahub/screener",
-    "screener.fields": "/datahub/screener/metadata"
+    "screener.fields": "/datahub/screener/metadata",
+    
+    # KV store endpoints
+    "kv.create": "/kv/{strategy_id}/{key}",
+    "kv.get": "/kv/{strategy_id}/{key}",
+    "kv.update": "/kv/{strategy_id}/{key}",
+    "kv.patch": "/kv/{strategy_id}/{key}",
+    "kv.delete": "/kv/{strategy_id}/{key}",
+    "kv.list": "/kv/{strategy_id}",
+    "kv.keys": "/kv/{strategy_id}/keys",
+    "kv.delete_all": "/kv/{strategy_id}/all"
   }
   
   def __init__(
@@ -1794,3 +1811,426 @@ class WizzerClient:
       if hasattr(e.response, 'text'):
         logger.error("Response content: %s", e.response.text)
       raise
+
+  # ===== KV STORE METHODS =====
+
+  def create_kv(self, key: str, value: Any, ttl: Optional[int] = None) -> Dict[str, Any]:
+    """
+    Create a new key-value pair.
+    
+    Args:
+        key (str): The key for the KV pair.
+        value (Any): The value to store (any JSON-serializable type).
+        ttl (Optional[int]): Time to live in seconds. If provided, the key will expire after this duration.
+    
+    Returns:
+        Dict[str, Any]: Response containing key, value, type, ttl, createdAt, updatedAt.
+        
+    Example Response:
+        {
+            "key": "state",
+            "value": {"positions": 30},
+            "type": "object", 
+            "ttl": 100,
+            "createdAt": "2023-10-01T10:00:00Z",
+            "updatedAt": "2023-10-01T10:00:00Z"
+        }
+    
+    Raises:
+        ValueError: If key is empty or invalid.
+        requests.RequestException: If key already exists (409 Conflict) or API request fails.
+    
+    Example:
+        client.create_kv(key="portfolio_state", value={"positions": 30}, ttl=3600)
+    """
+    if not key or not key.strip():
+      raise ValueError("Key cannot be empty or whitespace")
+    
+    # Get strategy information
+    strategy_info = self._get_strategy()
+    endpoint = self._routes["kv.create"].format(strategy_id=strategy_info["id"], key=key)
+    
+    # Build request payload
+    data = {"value": value}
+    if ttl is not None:
+      data["ttl"] = ttl
+    
+    logger.debug("Creating KV pair: key=%s, type=%s, ttl=%s", key, type(value).__name__, ttl)
+    return self._make_request("POST", endpoint, json=data)
+
+  def get_kv(self, key: str) -> Dict[str, Any]:
+    """
+    Retrieve a key-value pair.
+    
+    Args:
+        key (str): The key to retrieve.
+    
+    Returns:
+        Dict[str, Any]: Response containing value, type, and optional ttl.
+        
+    Example Response:
+        {
+            "value": {"positions": 30},
+            "type": "object",
+            "ttl": 85
+        }
+    
+    Raises:
+        ValueError: If key is empty or invalid.
+        requests.RequestException: If key not found (404) or API request fails.
+    
+    Example:
+        data = client.get_kv("portfolio_state")
+        positions = data["value"]["positions"]
+    """
+    if not key or not key.strip():
+      raise ValueError("Key cannot be empty or whitespace")
+    
+    # Get strategy information
+    strategy_info = self._get_strategy()
+    endpoint = self._routes["kv.get"].format(strategy_id=strategy_info["id"], key=key)
+    
+    logger.debug("Retrieving KV pair: key=%s", key)
+    return self._make_request("GET", endpoint)
+
+  def update_kv(self, key: str, value: Any, ttl: Optional[int] = None) -> Dict[str, Any]:
+    """
+    Update (replace) an existing key-value pair completely.
+    
+    Args:
+        key (str): The key to update.
+        value (Any): The new value to store (any JSON-serializable type).
+        ttl (Optional[int]): New time to live in seconds.
+    
+    Returns:
+        Dict[str, Any]: Response containing key, value, type, ttl, createdAt, updatedAt.
+        
+    Example Response:
+        {
+            "key": "state",
+            "value": {"positions": 50, "orders": 10},
+            "type": "object",
+            "ttl": 200,
+            "createdAt": "2023-10-01T10:00:00Z", 
+            "updatedAt": "2023-10-01T10:30:00Z"
+        }
+    
+    Raises:
+        ValueError: If key is empty or invalid.
+        requests.RequestException: If key not found (404) or API request fails.
+    
+    Example:
+        client.update_kv(key="portfolio_state", value={"positions": 50}, ttl=1800)
+    """
+    if not key or not key.strip():
+      raise ValueError("Key cannot be empty or whitespace")
+    
+    # Get strategy information
+    strategy_info = self._get_strategy()
+    endpoint = self._routes["kv.update"].format(strategy_id=strategy_info["id"], key=key)
+    
+    # Build request payload
+    data = {"value": value}
+    if ttl is not None:
+      data["ttl"] = ttl
+    
+    logger.debug("Updating KV pair: key=%s, type=%s, ttl=%s", key, type(value).__name__, ttl)
+    return self._make_request("PUT", endpoint, json=data)
+
+  def patch_kv(self, key: str, value: Optional[Any] = None, ttl: Optional[int] = None) -> Dict[str, Any]:
+    """
+    Partially update a key-value pair.
+    
+    For OBJECT types: merges the new value with existing value.
+    For other types (STRING, NUMBER, BOOLEAN, ARRAY): replaces the value entirely.
+    
+    Args:
+        key (str): The key to patch.
+        value (Optional[Any]): New value or partial value to merge.
+        ttl (Optional[int]): New time to live in seconds.
+        
+    Note: At least one of value or ttl must be provided.
+    
+    Returns:
+        Dict[str, Any]: Response containing key, value, type, ttl, createdAt, updatedAt.
+        
+    Example Response (for object merge):
+        {
+            "key": "state", 
+            "value": {"positions": 30, "orders": 5, "last_update": "2023-10-01"},  # Merged
+            "type": "object",
+            "ttl": 150,
+            "createdAt": "2023-10-01T10:00:00Z",
+            "updatedAt": "2023-10-01T10:15:00Z"
+        }
+    
+    Raises:
+        ValueError: If key is empty, invalid, or no parameters provided.
+        requests.RequestException: If key not found (404) or API request fails.
+    
+    Example:
+        # For objects - merges with existing
+        client.patch_kv(key="portfolio_state", value={"last_update": "2023-10-01"})
+        
+        # For non-objects - replaces entirely
+        client.patch_kv(key="counter", value=42)
+        
+        # Update only TTL
+        client.patch_kv(key="session", ttl=1800)
+    """
+    if not key or not key.strip():
+      raise ValueError("Key cannot be empty or whitespace")
+    
+    if value is None and ttl is None:
+      raise ValueError("At least one of value or ttl must be provided")
+    
+    # Get strategy information
+    strategy_info = self._get_strategy()
+    endpoint = self._routes["kv.patch"].format(strategy_id=strategy_info["id"], key=key)
+    
+    # Build request payload
+    data = {}
+    if value is not None:
+      data["value"] = value
+    if ttl is not None:
+      data["ttl"] = ttl
+    
+    logger.debug("Patching KV pair: key=%s, has_value=%s, has_ttl=%s", key, value is not None, ttl is not None)
+    return self._make_request("PATCH", endpoint, json=data)
+
+  def delete_kv(self, key: str) -> Dict[str, Any]:
+    """
+    Delete a key-value pair.
+    
+    Args:
+        key (str): The key to delete.
+    
+    Returns:
+        Dict[str, Any]: Success confirmation.
+        
+    Example Response:
+        {
+            "success": True,
+            "message": "Key deleted successfully"
+        }
+    
+    Raises:
+        ValueError: If key is empty or invalid.
+        requests.RequestException: If key not found (404) or API request fails.
+    
+    Example:
+        response = client.delete_kv("old_config")
+        if response["success"]:
+            print("Key deleted successfully")
+    """
+    if not key or not key.strip():
+      raise ValueError("Key cannot be empty or whitespace")
+    
+    # Get strategy information
+    strategy_info = self._get_strategy()
+    endpoint = self._routes["kv.delete"].format(strategy_id=strategy_info["id"], key=key)
+    
+    logger.debug("Deleting KV pair: key=%s", key)
+    return self._make_request("DELETE", endpoint)
+
+  def get_all_kvs(self, page_no: int = 1, paginate: bool = False) -> List[Dict[str, Any]]:
+    """
+    Get all key-value pairs with their complete data.
+    
+    Args:
+        page_no (int): Page number for pagination (default: 1).
+        paginate (bool): If True, automatically fetch all pages (default: False).
+    
+    Returns:
+        List[Dict[str, Any]]: List of all KV pairs with complete data.
+        
+    Example Response:
+        [
+            {
+                "key": "portfolio_state",
+                "value": {"positions": 30},
+                "type": "object",
+                "ttl": 100,
+                "createdAt": "2023-10-01T10:00:00Z",
+                "updatedAt": "2023-10-01T10:00:00Z"
+            },
+            {
+                "key": "environment",
+                "value": "production",
+                "type": "string", 
+                "createdAt": "2023-10-01T09:00:00Z",
+                "updatedAt": "2023-10-01T09:00:00Z"
+            },
+            {
+                "key": "trade_count",
+                "value": 42,
+                "type": "number",
+                "createdAt": "2023-10-01T08:00:00Z",
+                "updatedAt": "2023-10-01T08:30:00Z"
+            }
+        ]
+    
+    Example:
+        # Get first page only
+        kvs = client.get_all_kvs()
+        
+        # Get all pages automatically
+        all_kvs = client.get_all_kvs(paginate=True)
+    """
+    # Get strategy information
+    strategy_info = self._get_strategy()
+    endpoint = self._routes["kv.list"].format(strategy_id=strategy_info["id"])
+    
+    if paginate:
+      return self._paginate_kv_requests(endpoint, "get_all_kvs")
+    else:
+      params = {"pageNo": page_no}
+      logger.debug("Fetching all KVs page %d", page_no)
+      return self._make_request("GET", endpoint, params=params)
+
+  def get_kv_keys(self, page_no: int = 1, paginate: bool = False) -> List[Dict[str, Any]]:
+    """
+    Get all keys with metadata (without values for memory efficiency).
+    
+    Args:
+        page_no (int): Page number for pagination (default: 1).
+        paginate (bool): If True, automatically fetch all pages (default: False).
+    
+    Returns:
+        List[Dict[str, Any]]: List of keys with metadata (no values).
+        
+    Example Response:
+        [
+            {
+                "key": "portfolio_state",
+                "type": "object",
+                "ttl": 100,
+                "createdAt": "2023-10-01T10:00:00Z",
+                "updatedAt": "2023-10-01T10:00:00Z"
+            },
+            {
+                "key": "environment", 
+                "type": "string",
+                "createdAt": "2023-10-01T09:00:00Z",
+                "updatedAt": "2023-10-01T09:00:00Z"
+            },
+            {
+                "key": "trade_count",
+                "type": "number",
+                "createdAt": "2023-10-01T08:00:00Z",
+                "updatedAt": "2023-10-01T08:30:00Z"
+            }
+        ]
+    
+    Example:
+        # Get keys for first page
+        keys = client.get_kv_keys()
+        
+        # Get all keys across all pages
+        all_keys = client.get_kv_keys(paginate=True)
+        
+        # Check what keys exist
+        for key_info in all_keys:
+            print(f"Key: {key_info['key']}, Type: {key_info['type']}")
+    """
+    # Get strategy information
+    strategy_info = self._get_strategy()
+    endpoint = self._routes["kv.keys"].format(strategy_id=strategy_info["id"])
+    
+    if paginate:
+      return self._paginate_kv_requests(endpoint, "get_kv_keys")
+    else:
+      params = {"pageNo": page_no}
+      logger.debug("Fetching KV keys page %d", page_no)
+      return self._make_request("GET", endpoint, params=params)
+
+  def _paginate_kv_requests(self, endpoint: str, operation: str) -> List[Dict[str, Any]]:
+    """
+    Internal method to handle pagination for KV list operations.
+    
+    Args:
+        endpoint (str): API endpoint.
+        operation (str): Operation name for logging.
+        
+    Returns:
+        List[Dict[str, Any]]: Combined results from all pages.
+    """
+    all_items = []
+    page_no = 1
+    total_count = None
+    page_size = 20  # KV API uses 20 items per page
+    
+    while True:
+      params = {"pageNo": page_no}
+      logger.debug("Fetching %s page %d", operation, page_no)
+      
+      try:
+        url = f"{self.base_url}{endpoint}"
+        response = requests.request(
+          method="GET",
+          url=url,
+          headers=self.headers,
+          params=params
+        )
+        response.raise_for_status()
+        
+        # Get items from the current page
+        items = response.json()
+        all_items.extend(items)
+        
+        # Check if we need to fetch more pages
+        if total_count is None and "X-Total-Count" in response.headers:
+          try:
+            total_count = int(response.headers["X-Total-Count"])
+            logger.debug("Total %s count: %d", operation, total_count)
+          except (ValueError, TypeError):
+            logger.warning("Could not parse X-Total-Count header for %s", operation)
+            break
+        
+        # If we've fetched all items or there are no more pages, stop
+        if not items or len(all_items) >= total_count or total_count is None:
+          break
+        
+        # Move to the next page
+        page_no += 1
+        
+      except requests.RequestException as e:
+        logger.error("API request failed during %s pagination: %s", operation, e, exc_info=True)
+        if hasattr(e.response, 'text'):
+          logger.error("Response content: %s", e.response.text)
+        raise
+    
+    logger.info("Fetched %d items in total for %s", len(all_items), operation)
+    return all_items
+  
+  # Add this method to the WizzerClient class
+  def delete_all_kv(self) -> Dict[str, Any]:
+    """
+    Delete all key-value pairs for the current strategy.
+    
+    This method removes all KV pairs associated with the client's strategy.
+    Use with caution as this operation cannot be undone.
+    
+    Returns:
+        Dict[str, Any]: Response containing success status, count of deleted items, and message.
+        
+    Example Response:
+        {
+            "success": True,
+            "deleted": 15,
+            "message": "Successfully deleted 15 key-value pairs"
+        }
+    
+    Raises:
+        requests.RequestException: If API request fails.
+    
+    Example:
+        response = client.delete_all_kv()
+        print(f"Deleted {response['deleted']} key-value pairs")
+    """
+    # Get strategy information
+    strategy_info = self._get_strategy()
+    endpoint = self._routes["kv.delete_all"].format(strategy_id=strategy_info["id"])
+    
+    logger.debug("Deleting all KV pairs for strategy: %s", strategy_info["id"])
+    return self._make_request("DELETE", endpoint)

wiz_trader/quotes/client.py

@@ -28,15 +28,38 @@ class QuotesClient:
       log_level (str): Logging level. Options: "error", "info", "debug".
       on_tick (Callable): Callback for tick messages (type='ticks' or no type field).
       on_stats (Callable): Callback for stats/greeks messages (type='greeks').
+      on_order (Callable): Callback for order events (type='order').
+      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_connect (Callable): Callback when connection is established.
       on_close (Callable): Callback when connection is closed.
       on_error (Callable): Callback for errors.
     
     Message Routing:
-      - Messages with type='ticks' are routed to on_tick callback
-      - Messages with type='greeks' are routed to on_stats callback
+      - Legacy messages with type='ticks' are routed to on_tick callback
+      - Legacy messages with type='greeks' are routed to on_stats callback
+      - Event messages with type='order' are routed to on_order callback
+      - 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
       - Messages without type field are routed to on_tick for backward compatibility
       - Messages are silently dropped if the appropriate handler is not registered
+    
+    Message Structure Support:
+      - Legacy Format: {type: "ticks", ...data} or {...data} (no type)
+      - New Event Format: {type: "position", data: {...actualData}} - automatically normalized
+      - All handlers receive flattened message structure with type preserved at root level
+    
+    Event Handler Signature:
+      All event handlers follow the same signature: handler(ws: QuotesClient, event_data: dict)
+      
+    Example:
+      def on_order_event(ws, order):
+          print(f"Order {order['id']}: {order['status']}")
+      
+      client.on_order = on_order_event
+      client.connect()
     """
 
     ACTION_SUBSCRIBE = "subscribe"
@@ -89,6 +112,12 @@ class QuotesClient:
         self.on_connect: Optional[Callable[[Any], None]] = None
         self.on_close: Optional[Callable[[Any, Optional[int], Optional[str]], None]] = None
         self.on_error: Optional[Callable[[Any, Exception], None]] = None
+        
+        # Event callbacks for account events
+        self.on_order: Optional[Callable[[Any, dict], None]] = None
+        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
 
         logger.debug("Initialized QuotesClient with URL: %s", self.url)
 
@@ -96,6 +125,40 @@ class QuotesClient:
         for i in range(0, len(data), chunk_size):
             yield data[i:i + chunk_size]
 
+    def _normalize_message(self, raw_message: dict) -> dict:
+        """
+        Normalize message structure to handle both legacy and new formats.
+        
+        Legacy Format (Ticks/Greeks): {type: "ticks", ...data} or {...data} (no type)
+        New Format (Events): {type: "position", data: {...actualData}}
+        
+        Returns: Flattened message with type preserved at root level
+        """
+        try:
+            # Check if message has both 'type' and 'data' fields (new format)
+            if 'type' in raw_message and 'data' in raw_message:
+                # New format: Extract type, merge data into root level
+                message_type = raw_message['type']
+                data = raw_message['data']
+                if isinstance(data, dict):
+                    # Create flattened message with type preserved
+                    normalized = {'type': message_type}
+                    normalized.update(data)
+                    logger.debug("Normalized new format message: type=%s", message_type)
+                    return normalized
+                else:
+                    # Data is not a dict, keep original structure
+                    logger.debug("Data field is not a dict, keeping original structure")
+                    return raw_message
+            else:
+                # Legacy format: Use as-is (either has type only or no type)
+                logger.debug("Legacy format message detected")
+                return raw_message
+                
+        except Exception as e:
+            logger.debug("Error normalizing message: %s, using original", e)
+            return raw_message
+
     async def _connect_with_backoff(self) -> None:
         backoff = self._backoff_base
 
@@ -174,24 +237,67 @@ class QuotesClient:
                         if not chunk:
                             continue
                         try:
-                            data = json.loads(chunk)
+                            raw_data = json.loads(chunk)
+                            # Normalize message structure
+                            data = self._normalize_message(raw_data)
                             # Route based on message type
                             message_type = data.get('type')
                             
                             if message_type == 'greeks':
                                 if self.on_stats:
-                                    self.on_stats(self, data)
+                                    try:
+                                        self.on_stats(self, data)
+                                    except Exception as e:
+                                        logger.debug("Error in on_stats handler: %s", e)
                                 else:
                                     logger.debug("Received greeks message but no on_stats handler registered")
                             elif message_type == 'ticks':
                                 if self.on_tick:
-                                    self.on_tick(self, data)
+                                    try:
+                                        self.on_tick(self, data)
+                                    except Exception as e:
+                                        logger.debug("Error in on_tick handler: %s", e)
                                 else:
                                     logger.debug("Received ticks message but no on_tick handler registered")
+                            elif message_type == 'order':
+                                if self.on_order:
+                                    try:
+                                        self.on_order(self, data)
+                                    except Exception as e:
+                                        logger.debug("Error in on_order handler: %s", e)
+                                else:
+                                    logger.debug("Received order event but no on_order handler registered")
+                            elif message_type == 'trade':
+                                if self.on_trade:
+                                    try:
+                                        self.on_trade(self, data)
+                                    except Exception as e:
+                                        logger.debug("Error in on_trade handler: %s", e)
+                                else:
+                                    logger.debug("Received trade event but no on_trade handler registered")
+                            elif message_type == 'position':
+                                if self.on_position:
+                                    try:
+                                        self.on_position(self, data)
+                                    except Exception as e:
+                                        logger.debug("Error in on_position handler: %s", e)
+                                else:
+                                    logger.debug("Received position event but no on_position handler registered")
+                            elif message_type == 'holding':
+                                if self.on_holding:
+                                    try:
+                                        self.on_holding(self, data)
+                                    except Exception as e:
+                                        logger.debug("Error in on_holding handler: %s", e)
+                                else:
+                                    logger.debug("Received holding event but no on_holding handler registered")
                             else:
                                 # No type field - send to on_tick for backward compatibility
                                 if self.on_tick:
-                                    self.on_tick(self, data)
+                                    try:
+                                        self.on_tick(self, data)
+                                    except Exception as e:
+                                        logger.debug("Error in on_tick handler: %s", e)
                                 else:
                                     logger.debug("Received message without type field and no on_tick handler registered")
                         except json.JSONDecodeError as e:

{wiz_trader-0.34.0.dist-info → wiz_trader-0.36.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wiz_trader
-Version: 0.34.0
+Version: 0.36.0
 Summary: A Python SDK for connecting to the Wizzer.
 Home-page: https://bitbucket.org/wizzer-tech/quotes_sdk.git
 Author: Pawan Wagh
@@ -38,6 +38,7 @@ Dynamic: requires-python
     - [Callbacks](#callbacks)
     - [Subscribing to Instruments](#subscribing-to-instruments)
     - [Unsubscribing from Instruments](#unsubscribing-from-instruments)
+    - [Account Events](#account-events)
     - [Handling WebSocket Connection](#handling-websocket-connection)
     - [Complete Examples](#quotes-client-examples)
 5. [Wizzer Client](#wizzer-client)
@@ -253,6 +254,347 @@ ws.unsubscribe(["NSE:RELIANCE:2885"])
 - Can be called multiple times for different instrument sets
 - No callback fired for unsubscribed instruments
 
+### Account Events
+
+The QuotesClient now supports automatic reception of account-related events (orders, trades, positions, holdings) from the quotes server. These events are automatically pushed to SDK users via dedicated callback handlers based on the event type.
+
+#### Event Handlers
+
+Register event handlers to receive real-time updates for your account activity:
+
+```python
+def on_order(ws, order):
+    print(f"Order event: {order}")
+
+def on_trade(ws, trade):
+    print(f"Trade event: {trade}")
+
+def on_position(ws, position):
+    print(f"Position event: {position}")
+
+def on_holding(ws, holding):
+    print(f"Holding event: {holding}")
+
+# Register event handlers
+client.on_order = on_order
+client.on_trade = on_trade
+client.on_position = on_position
+client.on_holding = on_holding
+```
+
+#### Key Features
+
+- **Automatic Event Reception**: No explicit subscription needed - events are automatically sent based on your JWT token's account ID and strategy ID
+- **Optional Handlers**: Events are silently dropped if no handler is registered - you only receive what you need
+- **Message Normalization**: The SDK automatically handles different message formats and delivers clean, flattened event data to your handlers
+- **Error Resilience**: Handler exceptions are caught and logged without breaking the event flow
+- **Backward Compatible**: Existing tick and Greeks functionality remains unchanged
+
+#### Event Data Structure
+
+All event handlers receive flattened event data with the event type preserved:
+
+```python
+# Example order event data
+{
+    "_id": "order_01k10np7weemkv812nx55bppw5",
+    "accountEntityType": "client",
+    "accountId": "user_01j9brznsffphvzqn9gzyj1frw",
+    "avgPrice": 72.65,
+    "broker": "wizzer",
+    "brokerOrderId": "dssorder_175344314711184",
+    "brokerTimestamp": "2025-07-25T11:32:28.147Z",
+    "cancelledQty": 0,
+    "completedAt": "2025-07-25T11:32:28.147Z",
+    "createdAt": "2025-07-25T11:32:27.722Z",
+    "disclosedQty": 0,
+    "exchange": "NSE",
+    "exchangeOrderId": "dssx_1753443147",
+    "exchangeToken": 11184,
+    "exchangeUpdateTimestamp": "2025-07-25T11:32:28.147Z",
+    "executionType": "regular",
+    "filledQty": 1,
+    "guid": "t0lVueivgBgcEh2k_BP",
+    "instrumentType": "EQLC",
+    "isDealer": false,
+    "isOrderModified": false,
+    "legs": [],
+    "marginUsed": 0,
+    "meta": {
+        "dss": {"orderId": "order_01k10np7weemkv812nx55bppw5"},
+        "source": "wizzer.dss",
+        "wizzer": {"mode": "paper_trading"}
+    },
+    "orderType": "MARKET",
+    "parentOrderId": "",
+    "pendingQty": 1,
+    "placedBy": "user_01j9brznsffphvzqn9gzyj1frw",
+    "price": 0,
+    "product": "CNC",
+    "qty": 1,
+    "remarks": "",
+    "segment": "NSECM",
+    "slPrice": 0,
+    "slTriggerPrice": 0,
+    "sqOffHoldingId": "",
+    "sqOffPositionId": "",
+    "status": "COMPLETED",
+    "stoploss": 0,
+    "stoplossOrderId": "",
+    "strategy": {
+        "id": "stgy_01jtn7t3erf8ss78spqy40k8en",
+        "identifier": "S-608377",
+        "name": "Test 1122"
+    },
+    "target": 0,
+    "targetOrderId": "",
+    "tradingSymbol": "IDFCFIRSTB",
+    "transactionType": "BUY",
+    "triggerId": "",
+    "triggerPrice": 0,
+    "updatedAt": "2025-07-25T11:32:28.254Z",
+    "userId": "user_01j9brznsffphvzqn9gzyj1frw",
+    "validity": "DAY",
+    "variety": "REGULAR"
+}
+
+# Example trade event data
+{
+    "_id": "trade_01k10np8rqef793zr93ctqj0wt",
+    "accountId": "user_01j9brznsffphvzqn9gzyj1frw",
+    "avgPrice": 72.65,
+    "broker": "wizzer",
+    "brokerOrderId": "dssorder_175344314711184",
+    "createdAt": "2025-07-25T11:32:28.567Z",
+    "exchange": "NSE",
+    "exchangeOrderId": "dssx_1753443147",
+    "exchangeTimestamp": "2025-07-25T11:32:28.147Z",
+    "exchangeToken": 11184,
+    "isDividend": false,
+    "meta": {
+        "dss": {"orderId": "order_01k10np7weemkv812nx55bppw5"},
+        "source": "wizzer.dss",
+        "wizzer": {"mode": "paper_trading"}
+    },
+    "orderId": "order_01k10np7weemkv812nx55bppw5",
+    "orderType": "MARKET",
+    "parentOrderId": "",
+    "parentTradeId": "",
+    "product": "CNC",
+    "qty": 1,
+    "segment": "NSECM",
+    "strategy": {
+        "id": "stgy_01jtn7t3erf8ss78spqy40k8en",
+        "identifier": "S-608377",
+        "name": "Test 1122"
+    },
+    "tradeId": "dsstrade_50PccSfWvsCg-Cr5dQE",
+    "tradingSymbol": "IDFCFIRSTB",
+    "transactionType": "BUY",
+    "updatedAt": "2025-07-25T11:32:28.567Z",
+    "userId": "user_01j9brznsffphvzqn9gzyj1frw"
+}
+
+# Example position event data
+{
+    "_id": "pos_01k10np8t7e0fs63q52hacbx8m",
+    "accountEntityType": "client",
+    "accountId": "user_01j9brznsffphvzqn9gzyj1frw",
+    "bep": 0,
+    "broker": "wizzer",
+    "buyAvgPrice": 72.65,
+    "buyOrders": ["order_01k10np7weemkv812nx55bppw5"],
+    "buyQty": 1,
+    "buyTrades": ["trade_01k10np8rqef793zr93ctqj0wt"],
+    "buyValue": 72.65,
+    "closePrice": 0,
+    "createdAt": "2025-07-25T11:32:28.614Z",
+    "exchange": "NSE",
+    "exchangeToken": 11184,
+    "instrumentType": "EQLC",
+    "lotSize": 1,
+    "meta": {
+        "source": "wizzer.dss",
+        "wizzer": {"mode": "paper_trading"}
+    },
+    "netQty": 1,
+    "pnlPercentage": 0,
+    "product": "CNC",
+    "realisedPnlToday": 0,
+    "segment": "NSECM",
+    "sellAvgPrice": 0,
+    "sellOrders": [],
+    "sellQty": 0,
+    "sellTrades": [],
+    "sellValue": 0,
+    "slPrice": null,
+    "slTriggerPrice": null,
+    "status": "open",
+    "stoploss": 0,
+    "strategy": {
+        "id": "stgy_01jtn7t3erf8ss78spqy40k8en",
+        "identifier": "S-608377",
+        "name": "Test 1122"
+    },
+    "target": 0,
+    "tradingSymbol": "IDFCFIRSTB",
+    "unrealisedPnlToday": 0,
+    "updatedAt": "2025-07-25T11:32:28.614Z",
+    "userId": "user_01j9brznsffphvzqn9gzyj1frw"
+}
+
+# Example holding event data
+{
+    "_id": "holding_01k10np8t7e0fs63q52hacbx8m",
+    "accountEntityType": "client",
+    "accountId": "user_01j9brznsffphvzqn9gzyj1frw",
+    "bep": 0,
+    "broker": "wizzer",
+    "buyAvgPrice": 72.65,
+    "buyOrders": ["order_01k10np7weemkv812nx55bppw5"],
+    "buyQty": 1,
+    "buyTrades": ["trade_01k10np8rqef793zr93ctqj0wt"],
+    "buyValue": 72.65,
+    "closePrice": 0,
+    "createdAt": "2025-07-25T11:32:28.614Z",
+    "exchange": "NSE",
+    "exchangeToken": 11184,
+    "instrumentType": "EQLC",
+    "lotSize": 1,
+    "meta": {
+        "source": "wizzer.dss",
+        "wizzer": {"mode": "paper_trading"}
+    },
+    "netQty": 1,
+    "pnlPercentage": 0,
+    "product": "CNC",
+    "realisedPnlToday": 0,
+    "segment": "NSECM",
+    "sellAvgPrice": 0,
+    "sellOrders": [],
+    "sellQty": 0,
+    "sellTrades": [],
+    "sellValue": 0,
+    "slPrice": null,
+    "slTriggerPrice": null,
+    "status": "open",
+    "stoploss": 0,
+    "strategy": {
+        "id": "stgy_01jtn7t3erf8ss78spqy40k8en",
+        "identifier": "S-608377",
+        "name": "Test 1122"
+    },
+    "target": 0,
+    "tradingSymbol": "IDFCFIRSTB",
+    "unrealisedPnlToday": 0,
+    "updatedAt": "2025-07-25T11:32:28.614Z",
+    "userId": "user_01j9brznsffphvzqn9gzyj1frw"
+}
+```
+
+#### Complete Event Handling Example
+
+```python
+from wiz_trader import QuotesClient
+
+# Initialize client
+client = QuotesClient(
+    base_url="wss://websocket-url/quotes",
+    token="your-jwt-token",
+    log_level="info"
+)
+
+def on_order(ws, order):    
+    # React to order status changes
+    if order['status'] == ORDER_STATUS_COMPLETED:
+        print(f"Order {order['_id']} completed!")
+    elif order['status'] == ORDER_STATUS_REJECTED:
+        print(f"Order {order['_id']} rejected: {order.get('remarks', 'Unknown')}")
+
+def on_trade(ws, trade):
+    print(f"Trade executed: {trade['qty']} x {trade['tradingSymbol']} @ {trade['avgPrice']}")
+
+def on_position(ws, position):
+    print(f"Position update: {position['tradingSymbol']} = {position['netQty']} (PnL: {position.get('unrealisedPnlToday', 0)})")
+
+def on_holding(ws, holding):
+    print(f"Holding update: {holding['tradingSymbol']} = {holding['netQty']}")
+
+def on_connect(ws):
+    print("Connected! Ready to receive events.")
+    # Also subscribe to some ticks if needed
+    ws.subscribe(["NSE:SBIN:3045"], mode="ticks")
+
+# Register all handlers
+client.on_order = on_order
+client.on_trade = on_trade
+client.on_position = on_position
+client.on_holding = on_holding
+client.on_connect = on_connect
+
+# Connect and receive events
+client.connect()
+```
+
+#### Event-Driven Trading Strategy Example
+
+```python
+class EventDrivenStrategy:
+    def __init__(self):
+        self.orders = {}
+        self.positions = {}
+        self.pending_orders = set()
+    
+    def on_order_event(self, ws, order):
+        order_id = order['_id']
+        self.orders[order_id] = order
+        
+        # Track pending orders
+        if order['status'] == ORDER_STATUS_OPEN:
+            self.pending_orders.add(order_id)
+        elif order_id in self.pending_orders:
+            self.pending_orders.remove(order_id)
+        
+        # Log order lifecycle
+        print(f"Order {order_id}: {order['status']}")
+        
+        # React to rejections
+        if order['status'] == ORDER_STATUS_REJECTED:
+            print(f"Order rejected! Reason: {order.get('remarks', 'Unknown')}")
+            # Implement retry logic or alternative strategy
+    
+    def on_position_event(self, ws, position):
+        symbol = position['tradingSymbol']
+        self.positions[symbol] = position
+        
+        # Monitor position changes
+        print(f"Position {symbol}: Qty={position['netQty']}, PnL={position.get('unrealisedPnlToday', 0)}")
+        
+        # Implement stop-loss or take-profit logic
+        pnl = position.get('unrealisedPnlToday', 0)
+        if pnl < -100:  # Stop loss at -100
+            print(f"Stop loss triggered for {symbol}")
+            # Place exit order
+        elif pnl > 200:  # Take profit at 200
+            print(f"Take profit triggered for {symbol}")
+            # Place exit order
+    
+    def on_trade_event(self, ws, trade):
+        print(f"Trade executed: {trade['qty']} @ {trade['avgPrice']}")
+        # Update internal trade log, calculate VWAP, etc.
+
+# Initialize strategy
+strategy = EventDrivenStrategy()
+
+# Set up client with strategy handlers
+client = QuotesClient(base_url="wss://...", token="...")
+client.on_order = strategy.on_order_event
+client.on_position = strategy.on_position_event
+client.on_trade = strategy.on_trade_event
+
+client.connect()
+```
+
 ### Complete Examples
 
 #### Blocking Example
@@ -425,6 +767,7 @@ Available constants:
 - Transaction types: `TRANSACTION_TYPE_BUY`, `TRANSACTION_TYPE_SELL`
 - Product types: `PRODUCT_CNC`, `PRODUCT_MIS`, `PRODUCT_NRML`
 - Order types: `ORDER_TYPE_MARKET`, `ORDER_TYPE_LIMIT`, `ORDER_TYPE_SL`, `ORDER_TYPE_SLM`
+- Order status: `ORDER_STATUS_OPEN`, `ORDER_STATUS_CANCELLED`, `ORDER_STATUS_REJECTED`, `ORDER_STATUS_PENDING`, `ORDER_STATUS_COMPLETED`
 - Validity types: `VALIDITY_DAY`, `VALIDITY_IOC`, `VALIDITY_GTT`
 - Variety types: `VARIETY_REGULAR`, `VARIETY_AMO`, `VARIETY_BO`, `VARIETY_CO`
 - Exchanges: `EXCHANGE_NSE`, `EXCHANGE_BSE`, `EXCHANGE_WZR`
@@ -3663,3 +4006,243 @@ results = client.run_screener(
     limit=10
 )
 ```
+
+## KV Store Integration
+
+The WizzerClient includes comprehensive Key-Value (KV) store functionality for persistent data management. This feature allows you to store configuration data, state information, user preferences, and other persistent data associated with your trading strategies.
+
+### Supported Data Types
+
+The KV store supports all JSON-serializable data types:
+
+- **STRING**: Text values (`"production"`, `"user123"`)
+- **NUMBER**: Integer and float values (`42`, `150.25`)
+- **BOOLEAN**: True/false values (`True`, `False`)
+- **ARRAY**: Lists of values (`["AAPL", "GOOGL", "MSFT"]`)
+- **OBJECT**: Dictionaries/objects (`{"positions": 30, "cash": 50000}`)
+
+### Available Constants
+
+```python
+client.KV_TYPE_STRING   # "string"
+client.KV_TYPE_NUMBER   # "number" 
+client.KV_TYPE_BOOLEAN  # "boolean"
+client.KV_TYPE_ARRAY    # "array"
+client.KV_TYPE_OBJECT   # "object"
+```
+
+### Core CRUD Operations
+
+#### Create Key-Value Pair
+
+```python
+# Store different data types
+client.create_kv("environment", "production")
+client.create_kv("trade_count", 42)
+client.create_kv("is_active", True)
+client.create_kv("symbols", ["AAPL", "GOOGL", "MSFT"])
+
+# Store complex configuration with TTL (expires in 1 hour)
+config = {
+    "risk_level": "medium",
+    "max_positions": 10,
+    "stop_loss_pct": 0.05,
+    "take_profit_pct": 0.15
+}
+client.create_kv("strategy_config", config, ttl=3600)
+```
+
+#### Retrieve Key-Value Pair
+
+```python
+# Get a single KV pair
+data = client.get_kv("strategy_config")
+print(data["value"])          # The stored object
+print(data["type"])           # "object"
+print(data["ttl"])            # Remaining time to live (if set)
+
+# Access nested values
+risk_level = data["value"]["risk_level"]  # "medium"
+```
+
+#### Update Key-Value Pair (Complete Replacement)
+
+```python
+# Complete replacement of existing key
+new_config = {"risk_level": "high", "max_positions": 5}
+client.update_kv("strategy_config", new_config, ttl=1800)
+```
+
+#### Patch Key-Value Pair (Partial Update)
+
+```python
+# For objects - merges with existing data
+client.patch_kv("strategy_config", {"last_updated": "2024-01-15"})
+
+# For non-objects - replaces entirely  
+client.patch_kv("trade_count", 50)
+
+# Update only TTL
+client.patch_kv("strategy_config", ttl=7200)
+```
+
+#### Delete Key-Value Pair
+
+```python
+response = client.delete_kv("old_config")
+if response["success"]:
+    print("Key deleted successfully")
+```
+
+### List Operations
+
+#### Get All KV Pairs (with values)
+
+```python
+# Get first page (20 items)
+kvs = client.get_all_kvs(page_no=1)
+
+# Get all pages automatically
+all_kvs = client.get_all_kvs(paginate=True)
+
+for kv in all_kvs:
+    print(f"Key: {kv['key']}")
+    print(f"Type: {kv['type']}")
+    print(f"Value: {kv['value']}")
+```
+
+#### Get Keys Only (memory efficient)
+
+```python
+# Get all keys without values (faster for large datasets)
+keys = client.get_kv_keys(paginate=True)
+
+for key_info in keys:
+    print(f"Key: {key_info['key']}, Type: {key_info['type']}")
+    if 'ttl' in key_info:
+        print(f"  TTL: {key_info['ttl']} seconds remaining")
+```
+
+### Advanced Usage Examples
+
+#### Strategy Configuration Management
+
+```python
+# Store strategy parameters
+params = {
+    "moving_average_period": 20,
+    "rsi_oversold": 30,
+    "rsi_overbought": 70,
+    "position_size": 0.02
+}
+client.create_kv("strategy_params", params)
+
+# Update specific parameters using patch (merges with existing)
+client.patch_kv("strategy_params", {"moving_average_period": 50})
+```
+
+#### State Persistence
+
+```python
+# Save current portfolio state
+portfolio_state = {
+    "cash_balance": 50000,
+    "open_positions": 5,
+    "daily_pnl": 1250.75,
+    "last_updated": "2024-01-15T15:30:00Z"
+}
+client.create_kv("portfolio_state", portfolio_state, ttl=3600)
+
+# Update state periodically
+client.patch_kv("portfolio_state", {
+    "daily_pnl": 1500.25,
+    "last_updated": "2024-01-15T16:00:00Z"
+})
+```
+
+#### Feature Flags
+
+```python
+# Enable/disable features dynamically
+features = {
+    "advanced_charts": True,
+    "paper_trading": True,
+    "options_trading": False,
+    "algo_trading": True
+}
+client.create_kv("feature_flags", features)
+
+# Toggle a feature
+client.patch_kv("feature_flags", {"options_trading": True})
+```
+
+#### Data Caching with TTL
+
+```python
+# Cache market data with short TTL (5 minutes)
+market_status = {
+    "nse_open": True,
+    "bse_open": True,
+    "last_checked": "2024-01-15T09:15:00Z"
+}
+client.create_kv("market_status", market_status, ttl=300)
+```
+
+### Object Merge Behavior
+
+For OBJECT type data, the `patch_kv` method performs intelligent merging:
+
+```python
+# Initial object
+client.create_kv("user_prefs", {
+    "theme": "dark",
+    "notifications": True,
+    "language": "en"
+})
+
+# Patch merges new fields with existing ones
+client.patch_kv("user_prefs", {
+    "notifications": False,  # Updates existing field
+    "timezone": "UTC"        # Adds new field
+})
+
+# Result: {"theme": "dark", "notifications": False, "language": "en", "timezone": "UTC"}
+```
+
+### Delete All KV Pairs
+
+The `delete_all_kv` method allows you to remove all key-value pairs for a strategy at once:
+
+```python
+# Delete all KV pairs for the current strategy
+response = client.delete_all_kv()
+print(f"Deleted {response['deleted']} key-value pairs")
+
+# Example response:
+# {
+#     "success": True,
+#     "deleted": 15,
+#     "message": "Successfully deleted 15 key-value pairs"
+# }
+
+# Common usage - reset strategy state before reinitialization
+def reset_strategy_state():
+    """Reset all persistent state for the strategy."""
+    # Clear all existing KV pairs
+    result = client.delete_all_kv()
+    print(f"Cleared {result['deleted']} KV pairs")
+    
+    # Reinitialize with default configuration
+    client.create_kv("config", {
+        "mode": "production",
+        "risk_percentage": 0.02,
+        "max_positions": 10
+    })
+    client.create_kv("state", {
+        "initialized": True,
+        "start_time": datetime.now().isoformat()
+    })
+    print("Strategy state reset successfully")
+
+# Use with caution - this operation cannot be undone!
+```

wiz_trader-0.36.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+wiz_trader/__init__.py,sha256=hOpsoebZsI_XebFP-JQ-CenvIShBGtVDsJhl72ARJxU,183
+wiz_trader/apis/__init__.py,sha256=6sUr1nzmplNdld0zryMrQSt0jHT2GhOiFYgKKVHzk8U,133
+wiz_trader/apis/client.py,sha256=znwlyDIHbaiQuDqxp7pn1NPiiYB99oA74JWt4AiLkBg,80088
+wiz_trader/quotes/__init__.py,sha256=RF9g9CNP6bVWlmCh_ad8krm3-EWOIuVfLp0-H9fAeEM,108
+wiz_trader/quotes/client.py,sha256=cAGaysLCljZilYgX8Sf3V88F6dWlcewJf6TMOpSKb7I,20862
+wiz_trader-0.36.0.dist-info/METADATA,sha256=AYUF296FcogkDFjLk5WDhVeAaGvH1PhO8Gyl1g4aH3Q,155156
+wiz_trader-0.36.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+wiz_trader-0.36.0.dist-info/top_level.txt,sha256=lnYS_g8LlA6ryKYnvY8xIQ6K2K-xzOsd-99AWgnW6VY,11
+wiz_trader-0.36.0.dist-info/RECORD,,

wiz_trader-0.34.0.dist-info/RECORD

@@ -1,9 +0,0 @@
-wiz_trader/__init__.py,sha256=Bd8yqFEqK9MNrzHUVgrbEntlyIHZhArgA6AZT9SEFjY,183
-wiz_trader/apis/__init__.py,sha256=6sUr1nzmplNdld0zryMrQSt0jHT2GhOiFYgKKVHzk8U,133
-wiz_trader/apis/client.py,sha256=WzsKxrNi9T-xbtXWBT2J41bJ-sz0KsGFYV5Oyddo3gg,65487
-wiz_trader/quotes/__init__.py,sha256=RF9g9CNP6bVWlmCh_ad8krm3-EWOIuVfLp0-H9fAeEM,108
-wiz_trader/quotes/client.py,sha256=aZ5LVlrj0mKfgHgFxERmk2HDZraB6RMaormTOMlqWZc,14915
-wiz_trader-0.34.0.dist-info/METADATA,sha256=OAi5g0xbSdp9bc-F1Fgl7d8oMRIsfimTohtJ0oA-FX0,138653
-wiz_trader-0.34.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-wiz_trader-0.34.0.dist-info/top_level.txt,sha256=lnYS_g8LlA6ryKYnvY8xIQ6K2K-xzOsd-99AWgnW6VY,11
-wiz_trader-0.34.0.dist-info/RECORD,,