HedgeTech 0.2.0b1__py3-none-any.whl → 0.2.2b0__py3-none-any.whl

HedgeTech/EmsEngine/__tse_ifb/__SyncClient.py

@@ -20,11 +20,25 @@ from io import BytesIO
 
 class Order:
     
+    """
+    Represents a single trading order in EMS Engine.
+
+    This class provides methods to send, edit, check status,
+    and delete an order after creation.
+
+    An Order instance is usually created via
+    `EmsEngine_TseIfb_SyncClient` methods.
+    """
+    
     def __init__(
         self,
         *,
-        order_uuid : HexUUID,
+        SendOrder_RequestInfo : dict,
         AuthSyncClient : AuthSyncClient,
+        SymbolNameOrIsin : str,
+        Price : int,
+        Volume :int,
+        ValidityDate : int = 0,
         Order_ValidityType : Literal[
             'DAY',
             'GTC', # Good Till Cancelled
@@ -32,14 +46,46 @@ class Order:
             'FAK', # Fill And Kill
             'FOK', # Fill Or Kill
         ] = 'DAY',
-        ValidityDate : int = 0,
-        SymbolNameOrIsin : str,
-        Price : int,
-        Volume :int,
     ):
         
+        """
+        Initialize a new Order object.
+
+        Parameters
+        ----------
+        SendOrder_RequestInfo : dict
+            HTTP request configuration for sending the order.
+
+        AuthSyncClient : AuthSyncClient
+            Authenticated HTTP client.
+
+        Order_ValidityType : Literal
+            Order validity type.
+
+        ValidityDate : int
+            Expiration date (for GTD orders).
+
+        SymbolNameOrIsin : str
+            Symbol name or ISIN code.
+
+        Price : int
+            Order price.
+
+        Volume : int
+            Order volume.
+
+        Examples
+        --------
+        >>> order = client.Buy_by_Name(
+        ...     symbolName="اهرم",
+        ...     Price=12000,
+        ...     Volume=1000
+        ... )
+        """
+        
         self.__AuthSyncClient = AuthSyncClient
-        self.__order_uuid : HexUUID = order_uuid
+        self.__SendOrder_RequestInfo = SendOrder_RequestInfo
+        
         self.ValidityType : str = Order_ValidityType
         self.ValidityDate : int = ValidityDate
         self.SymbolNameOrIsin : str = SymbolNameOrIsin
@@ -47,12 +93,57 @@ class Order:
         self.Volume : int = Volume
         self.is_deleted : bool = False
         
+        self.OrderId : HexUUID | None = None   
+        
+
+    # +--------------------------------------------------------------------------------------+ #
+    
+    def send(self)-> None:
+        
+        """
+        Send the order to the trading engine.
+
+        This method submits the order to EMS Engine
+        and assigns OrderId on success.
+
+        Returns
+        -------
+        None
+
+        Notes
+        -----
+        - Can be called only once.
+        - Subsequent calls have no effect.
+
+        Examples
+        --------
+        >>> order.send()
+        >>> print(order.OrderId)
+        '0xA23F...'
+        """
+        
+        if self.OrderId is None : 
+        
+            SendOrder_Response = self.__AuthSyncClient.httpx_Client.post(**self.__SendOrder_RequestInfo)
+            
+            match SendOrder_Response.status_code :
+                
+                case 200 :
+                    
+                    self.OrderId = SendOrder_Response.json()['Data']['order_uuid']
+                    return None
+                    
+                case _ : return None
+            
+        else : return None
 
     # +--------------------------------------------------------------------------------------+ #
     
     def Edit(
         self,
         *,
+        Price : int,
+        Volume :int,
         Order_ValidityType : Literal[
             'DAY',
             'GTC', # Good Till Cancelled
@@ -61,112 +152,230 @@ class Order:
             'FOK', # Fill Or Kill
         ] = 'DAY',
         ValidityDate : int = 0,
-        Price : int,
-        Volume :int,
     )-> None:
         
-        Edit_response = self.__AuthSyncClient.httpx_Client.patch(
-            url='https://core.hedgetech.ir/ems-engine/tse-ifb/order/edit',
-            data={
-                'order_uuid' : self.__order_uuid,
-                'Order_ValidityType' : Order_ValidityType,
-                'ValidityDate' : ValidityDate,
-                'Price' : Price,
-                'Volume' : Volume
-            }
-        )
-        
-        
-        match Edit_response.status_code:
+        """
+        Edit an existing order.
+
+        Parameters
+        ----------
+        Order_ValidityType : Literal
+            New validity type.
+
+        ValidityDate : int
+            New expiration date.
+
+        Price : int
+            New order price.
+
+        Volume : int
+            New order volume.
+
+        Returns
+        -------
+        None
+
+        Raises
+        ------
+        None
+
+        Examples
+        --------
+        >>> order.Edit(Price=12500, Volume=800)
+        """
+        
+        if self.OrderId is not None: 
+        
+            Edit_response = self.__AuthSyncClient.httpx_Client.patch(
+                url='https://core.hedgetech.ir/ems-engine/tse-ifb/order/edit',
+                data={
+                    'order_uuid' : self.OrderId,
+                    'Order_ValidityType' : Order_ValidityType,
+                    'ValidityDate' : ValidityDate,
+                    'Price' : Price,
+                    'Volume' : Volume
+                }
+            )
             
-            case 200:
-                
-                Edit_response = Edit_response.json()
-                
-                self.__order_uuid = Edit_response['Data']['order_uuid']
-                self.ValidityType = Edit_response['Data']['order_validity_type']
-                self.ValidityDate = ValidityDate
-                self.Price = Edit_response['Data']['order_price']
-                self.Volume = Edit_response['Data']['order_volume']
-                
-            case 400:
-                
-                raise ValueError(Edit_response.json()['detail']['Status']['Description']['en'])
-                
-            case _ :
-                
-                raise ValueError(Edit_response.text)
-        
+            
+            match Edit_response.status_code:
+                
+                case 200:
+                    
+                    Edit_response = Edit_response.json()
+                    
+                    self.OrderId = Edit_response['Data']['order_uuid']
+                    self.ValidityType = Edit_response['Data']['order_validity_type']
+                    self.ValidityDate = ValidityDate
+                    self.Price = Edit_response['Data']['order_price']
+                    self.Volume = Edit_response['Data']['order_volume']
+                    
+                    return None
+                                    
+                case _ : return None
+        
+        else : return None
         
     # +--------------------------------------------------------------------------------------+ #
     
-    @property
-    def Status(self)-> OrderStatus:
+    def Status(self)-> OrderStatus | None:
         
-        status_respnse = self.__AuthSyncClient.httpx_Client.get(
-            url='https://core.hedgetech.ir/ems-engine/tse-ifb/order/status',
-            params={'order_uuid' : self.__order_uuid}
-        )
-        
-        match status_respnse.status_code :
+        """
+        Retrieve the current status of the order.
+
+        This method queries the EMS Engine and returns detailed
+        execution and lifecycle information of the order.
+
+        Returns
+        -------
+        OrderStatus | None
+            A dictionary containing order status information.
+
+            On success, the returned object contains the following fields:
+
+            - order_uuid : HexUUID
+                Unique identifier of the order.
+
+            - order_status : Literal['InQueue', 'Cancelled', 'Broken', 'Settled']
+                Current lifecycle state of the order.
+
+                * InQueue   : Order is waiting for execution.
+                * Cancelled : Order was cancelled.
+                * Broken    : Order was rejected or failed.
+                * Settled   : Order fully executed.
+
+            - Price : int
+                Order price.
+
+            - Volume : int
+                Total requested volume.
+
+            - RemainedVolume : int
+                Remaining unexecuted volume.
+
+            - ExecutedVolume : int
+                Total executed volume.
+
+            - OrderSide : Literal['Buy', 'Sell']
+                Side of the order.
+
+            - ValidityType : Literal['DAY', 'GTC', 'GTD']
+                Order validity type.
+
+            - ValidityDate : int
+                Expiration date (for GTD orders).
+
+            Returns None if the request fails or if the order
+            has not been sent yet.
+
+        Raises
+        ------
+        None
+
+        Notes
+        -----
+        - This method requires a valid OrderId.
+        - If OrderId is None, None is returned.
+        - Network or server errors are silently ignored.
+
+        Examples
+        --------
+        >>> status = order.Status()
+        >>> print(status["order_status"])
+        'Settled'
+
+        >>> print(status["ExecutedVolume"])
+        1000
+
+        >>> if status["RemainedVolume"] == 0:
+        ...     print("Order fully executed")
+
+        Example Output
+        --------------
+        {
+            "order_uuid": "0xA91F23BC...",
+            "order_status": "Settled",
+            "Price": 12000,
+            "Volume": 1000,
+            "RemainedVolume": 0,
+            "ExecutedVolume": 1000,
+            "OrderSide": "Buy",
+            "ValidityType": "DAY",
+            "ValidityDate": 0
+        }
+        """
+        
+        if self.OrderId is not None:  
+        
+            status_respnse = self.__AuthSyncClient.httpx_Client.get(
+                url='https://core.hedgetech.ir/ems-engine/tse-ifb/order/status',
+                params={'order_uuid' : self.OrderId}
+            )
             
-            case 200:
-                
-                return status_respnse.json()['Data']
+            match status_respnse.status_code :
                 
-            case 400:
-                
-                raise ValueError(status_respnse.json()['detail']['Status']['Description']['en'])
-
-            case _ :
+                case 200:
+                    
+                    return status_respnse.json()['Data']
+                    
+                case _ : return None
                 
-                raise ValueError(status_respnse.text)
-            
-    # +--------------------------------------------------------------------------------------+ #
-    
-    @property
-    def order_is_valid(self)-> bool:
-        
-        status = self.Status
-        
-        if (status['Price'] == self.Price) and (
-            status['Volume'] == self.Volume
-        ) and (status['ValidityType'] == self.ValidityType) and status['OrderInQueue']:
-            
-            return True
-        
-        else : return False
+        else : return None
         
     # +--------------------------------------------------------------------------------------+ #
     
-    @property
-    def Delete(self)-> bool :
-        
-        Delete_respnse =  self.__AuthSyncClient.httpx_Client.delete(
-            url= 'https://core.hedgetech.ir/ems-engine/tse-ifb/order/delete',
-            params={'order_uuid' : self.__order_uuid}
-        )
+    def Delete(self)-> None :
         
+        """
+        Cancel/Delete the order.
+
+        Sends delete request to EMS Engine.
+
+        Returns
+        -------
+        None
+
+        Notes
+        -----
+        After deletion, `is_deleted` becomes True.
 
-        match Delete_respnse.status_code :
+        Examples
+        --------
+        >>> order.Delete()
+        >>> print(order.is_deleted)
+        True
+        """
+        
+        if self.OrderId is not None:  
             
-            case 200:
-                
-                self.is_deleted = True
+            Delete_respnse =  self.__AuthSyncClient.httpx_Client.delete(
+                url= 'https://core.hedgetech.ir/ems-engine/tse-ifb/order/delete',
+                params={'order_uuid' : self.OrderId}
+            )
+            
+
+            match Delete_respnse.status_code :
                 
-            case 400:
+                case 200:
+                    
+                    self.is_deleted = True
+                    return None
                 
-                raise ValueError(Delete_respnse.json()['detail']['Status']['Description']['en'])
+                case _ : return None
         
-            case _ :
-                
-                raise ValueError(Delete_respnse.text)
-    
+        else : return None
             
 # ================================================================================= #
 
 class EmsEngine_TseIfb_SyncClient:
     
+    """
+    Synchronous EMS Engine client for TSE/IFB markets.
+
+    This client manages authentication, OMS login,
+    and order creation.
+    """
+    
     def __init__(
         self,
         AuthSyncClient : AuthSyncClient,
@@ -190,6 +399,30 @@ class EmsEngine_TseIfb_SyncClient:
         ]
     )-> ImageFile:
         
+        """
+        Fetch captcha image for OMS login.
+
+        Parameters
+        ----------
+        OMS : Literal
+            OMS provider name.
+
+        Returns
+        -------
+        ImageFile
+            Captcha image.
+
+        Raises
+        ------
+        ValueError
+            If server returns error.
+
+        Examples
+        --------
+        >>> img = client.Get_Captcha("Omex | Parsian")
+        >>> img.show()
+        """
+        
         Captcha = self.__AuthSyncClient.httpx_Client.get(
             url='https://core.hedgetech.ir/ems-engine/tse-ifb/oms/login',
             params={'oms' : OMS }
@@ -207,7 +440,34 @@ class EmsEngine_TseIfb_SyncClient:
         password: str,
         captcha_value: str,
     ) -> None :
+        """
+        Authenticate user in OMS system.
 
+        Parameters
+        ----------
+        username : str
+            Trading account username.
+
+        password : str
+            Trading account password.
+
+        captcha_value : str
+            Captcha solution.
+
+        Returns
+        -------
+        None
+
+        Raises
+        ------
+        ValueError
+            If authentication fails.
+
+        Examples
+        --------
+        >>> client.oms_login("user1", "pass123", "A7B9")
+        """
+        
         response = self.__AuthSyncClient.httpx_Client.post(
             url='https://core.hedgetech.ir/ems-engine/tse-ifb/oms/login',
             data={
@@ -245,6 +505,9 @@ class EmsEngine_TseIfb_SyncClient:
     def Buy_by_Name(
         self,
         *,
+        symbolName : str,
+        Price : int,
+        Volume :int,
         Order_ValidityType : Literal[
             'DAY',
             'GTC', # Good Till Cancelled
@@ -253,47 +516,60 @@ class EmsEngine_TseIfb_SyncClient:
             'FOK', # Fill Or Kill
         ] = 'DAY',
         ValidityDate : int = 0,
-        symbolName : str,
-        Price : int,
-        Volume :int,
-    )-> Order:
+    )-> Order | None:
         
-        order_response = self.__AuthSyncClient.httpx_Client.post(
-            url='https://core.hedgetech.ir/ems-engine/tse-ifb/order/new/buy/name',
-            data={
-                'oms_session' : self.oms_session,
-                'Order_ValidityType' : Order_ValidityType,
-                'ValidityDate' : ValidityDate,
-                'symbolName' : symbolName,
-                'Price' : Price,
-                'Volume' : Volume
-            }
-        )
-        
-        match order_response.status_code:
-            
+        """
+        Create a buy order using symbol name.
+
+        Parameters
+        ----------
+        symbolName : str
+            Trading symbol name.
+
+        Price : int
+            Order price.
+
+        Volume : int
+            Order volume.
+
+        Returns
+        -------
+        Order | None
+            Order instance if logged in, otherwise None.
+
+        Examples
+        --------
+        >>> order = client.Buy_by_Name(
+        ...     symbolName="اهرم",
+        ...     Price=12000,
+        ...     Volume=1000
+        ... )
+        >>> order.send()
+        """
+        
+        if self.oms_session is not None: 
+        
+            return Order(
+                AuthSyncClient=self.__AuthSyncClient,
+                Order_ValidityType=Order_ValidityType,
+                ValidityDate=ValidityDate,
+                SymbolNameOrIsin = symbolName,
+                Price=Price,
+                Volume=Volume,
+                SendOrder_RequestInfo = {
+                    'url' : 'https://core.hedgetech.ir/ems-engine/tse-ifb/order/new/buy/name',
+                    'data' : {
+                        'oms_session' : self.oms_session,
+                        'Order_ValidityType' : Order_ValidityType,
+                        'ValidityDate' : ValidityDate,
+                        'symbolName' : symbolName,
+                        'Price' : Price,
+                        'Volume' : Volume
+                    }
+                }
+            )
             
-            case 200:
-                
-                order_response = order_response.json()
-                
-                return Order(
-                    order_uuid=order_response['Data']['order_uuid'],
-                    AuthSyncClient=self.__AuthSyncClient,
-                    Order_ValidityType=Order_ValidityType,
-                    ValidityDate=ValidityDate,
-                    SymbolNameOrIsin = symbolName,
-                    Price=Price,
-                    Volume=Volume
-                )
-                
-            case 400:
-                
-                raise ValueError(order_response.json()['detail']['Status']['Description']['en'])
-                
-            case _ :
-                
-                raise ValueError(order_response.text)
+        else : return None
                         
 
     # +--------------------------------------------------------------------------------------+ #
@@ -302,6 +578,9 @@ class EmsEngine_TseIfb_SyncClient:
     def Sell_by_Name(
         self,
         *,
+        symbolName : str,
+        Price : int,
+        Volume :int,
         Order_ValidityType : Literal[
             'DAY',
             'GTC', # Good Till Cancelled
@@ -310,53 +589,69 @@ class EmsEngine_TseIfb_SyncClient:
             'FOK', # Fill Or Kill
         ] = 'DAY',
         ValidityDate : int = 0,
-        symbolName : str,
-        Price : int,
-        Volume :int,
-    )-> Order:
-        
-        order_response = self.__AuthSyncClient.httpx_Client.post(
-            url='https://core.hedgetech.ir/ems-engine/tse-ifb/order/new/sell/name',
-            data={
-                'oms_session' : self.oms_session,
-                'Order_ValidityType' : Order_ValidityType,
-                'ValidityDate' : ValidityDate,
-                'symbolName' : symbolName,
-                'Price' : Price,
-                'Volume' : Volume
-            }
-        )
+    )-> Order | None:
         
-        match order_response.status_code:
-            
+        """
+        Create a sell order using symbol name.
+
+        Parameters
+        ----------
+        symbolName : str
+            Trading symbol name.
+
+        Price : int
+            Order price.
+
+        Volume : int
+            Order volume.
+
+        Returns
+        -------
+        Order | None
+            Order instance if logged in, otherwise None.
+
+        Examples
+        --------
+        >>> order = client.Sell_by_Name(
+        ...     symbolName="اهرم",
+        ...     Price=12000,
+        ...     Volume=1000
+        ... )
+        >>> order.send()
+        """
+        
+        if self.oms_session is not None: 
+        
+            return Order(
+                AuthSyncClient=self.__AuthSyncClient,
+                Order_ValidityType=Order_ValidityType,
+                ValidityDate=ValidityDate,
+                SymbolNameOrIsin = symbolName,
+                Price=Price,
+                Volume=Volume,
+                SendOrder_RequestInfo = {
+                    'url' : 'https://core.hedgetech.ir/ems-engine/tse-ifb/order/new/sell/name',
+                    'data' : {
+                        'oms_session' : self.oms_session,
+                        'Order_ValidityType' : Order_ValidityType,
+                        'ValidityDate' : ValidityDate,
+                        'symbolName' : symbolName,
+                        'Price' : Price,
+                        'Volume' : Volume
+                    }
+                }
+            )
             
-            case 200:
-                
-                order_response = order_response.json()
-                
-                return Order(
-                    order_uuid=order_response['Data']['order_uuid'],
-                    AuthSyncClient=self.__AuthSyncClient,
-                    Order_ValidityType=Order_ValidityType,
-                    ValidityDate=ValidityDate,
-                    SymbolNameOrIsin = symbolName,
-                    Price=Price,
-                    Volume=Volume
-                )
-                
-            case 400:
-                
-                raise ValueError(order_response.json()['detail']['Status']['Description']['en'])
-                
-            case _ :
-                
-                raise ValueError(order_response.text)
+        else : return None
         
     # +--------------------------------------------------------------------------------------+ #
 
     def Buy_by_isin(
         self,
         *,
+        symbolIsin : str,
+        Price : int,
+        Volume :int,
         Order_ValidityType : Literal[
             'DAY',
             'GTC', # Good Till Cancelled
@@ -365,54 +660,69 @@ class EmsEngine_TseIfb_SyncClient:
             'FOK', # Fill Or Kill
         ] = 'DAY',
         ValidityDate : int = 0,
-        symbolIsin : str,
-        Price : int,
-        Volume :int,
-    )-> Order:
-        
-        order_response = self.__AuthSyncClient.httpx_Client.post(
-            url='https://core.hedgetech.ir/ems-engine/tse-ifb/order/new/buy/isin',
-            data={
-                'oms_session' : self.oms_session,
-                'Order_ValidityType' : Order_ValidityType,
-                'ValidityDate' : ValidityDate,
-                'symbolIsin' : symbolIsin,
-                'Price' : Price,
-                'Volume' : Volume
-            }
-        )
+    )-> Order | None:
         
-        match order_response.status_code:
-            
+        """
+        Create a buy order using symbol isin.
+
+        Parameters
+        ----------
+        symbolIsin : str
+            Trading symbol isin.
+
+        Price : int
+            Order price.
+
+        Volume : int
+            Order volume.
+
+        Returns
+        -------
+        Order | None
+            Order instance if logged in, otherwise None.
+
+        Examples
+        --------
+        >>> order = client.Buy_by_isin(
+        ...     symbolName="اهرم",
+        ...     Price=12000,
+        ...     Volume=1000
+        ... )
+        >>> order.send()
+        """
+        
+        if self.oms_session is not None: 
+        
+            return Order(
+                AuthSyncClient=self.__AuthSyncClient,
+                Order_ValidityType=Order_ValidityType,
+                ValidityDate=ValidityDate,
+                SymbolNameOrIsin = symbolIsin,
+                Price=Price,
+                Volume=Volume,
+                SendOrder_RequestInfo = {
+                    'url' : 'https://core.hedgetech.ir/ems-engine/tse-ifb/order/new/buy/isin',
+                    'data' : {
+                        'oms_session' : self.oms_session,
+                        'Order_ValidityType' : Order_ValidityType,
+                        'ValidityDate' : ValidityDate,
+                        'symbolIsin' : symbolIsin,
+                        'Price' : Price,
+                        'Volume' : Volume
+                    }
+                }
+            )
             
-            case 200:
-                
-                order_response = order_response.json()
-                
-                return Order(
-                    order_uuid=order_response['Data']['order_uuid'],
-                    AuthSyncClient=self.__AuthSyncClient,
-                    Order_ValidityType=Order_ValidityType,
-                    ValidityDate=ValidityDate,
-                    SymbolNameOrIsin = symbolIsin,
-                    Price=Price,
-                    Volume=Volume
-                )
-                
-            case 400:
-                
-                raise ValueError(order_response.json()['detail']['Status']['Description']['en'])
-                
-            case _ :
-                
-                raise ValueError(order_response.text)
-        
+        else : return None
         
     # +--------------------------------------------------------------------------------------+ #
     
     def Sell_by_isin(
         self,
         *,
+        symbolIsin : str,
+        Price : int,
+        Volume :int,
         Order_ValidityType : Literal[
             'DAY',
             'GTC', # Good Till Cancelled
@@ -421,47 +731,60 @@ class EmsEngine_TseIfb_SyncClient:
             'FOK', # Fill Or Kill
         ] = 'DAY',
         ValidityDate : int = 0,
-        symbolIsin : str,
-        Price : int,
-        Volume :int,
-    )-> Order:
-        
-        order_response = self.__AuthSyncClient.httpx_Client.post(
-            url='https://core.hedgetech.ir/ems-engine/tse-ifb/order/new/sell/isin',
-            data={
-                'oms_session' : self.oms_session,
-                'Order_ValidityType' : Order_ValidityType,
-                'ValidityDate' : ValidityDate,
-                'symbolIsin' : symbolIsin,
-                'Price' : Price,
-                'Volume' : Volume
-            }
-        )
+    )-> Order | None:
         
-        match order_response.status_code:
-            
+        """
+        Create a sell order using symbol isin.
+
+        Parameters
+        ----------
+        symbolIsin : str
+            Trading symbol isin.
+
+        Price : int
+            Order price.
+
+        Volume : int
+            Order volume.
+
+        Returns
+        -------
+        Order | None
+            Order instance if logged in, otherwise None.
+
+        Examples
+        --------
+        >>> order = client.Sell_by_isin(
+        ...     symbolName="اهرم",
+        ...     Price=12000,
+        ...     Volume=1000
+        ... )
+        >>> order.send()
+        """
+        
+        if self.oms_session is not None: 
+        
+            return Order(
+                AuthSyncClient=self.__AuthSyncClient,
+                Order_ValidityType=Order_ValidityType,
+                ValidityDate=ValidityDate,
+                SymbolNameOrIsin = symbolIsin,
+                Price=Price,
+                Volume=Volume,
+                SendOrder_RequestInfo = {
+                    'url' : 'https://core.hedgetech.ir/ems-engine/tse-ifb/order/new/sell/isin',
+                    'data' : {
+                        'oms_session' : self.oms_session,
+                        'Order_ValidityType' : Order_ValidityType,
+                        'ValidityDate' : ValidityDate,
+                        'symbolIsin' : symbolIsin,
+                        'Price' : Price,
+                        'Volume' : Volume
+                    }
+                }
+            )
             
-            case 200:
-                
-                order_response = order_response.json()
-                
-                return Order(
-                    order_uuid=order_response['Data']['order_uuid'],
-                    AuthSyncClient=self.__AuthSyncClient,
-                    Order_ValidityType=Order_ValidityType,
-                    ValidityDate=ValidityDate,
-                    SymbolNameOrIsin = symbolIsin,
-                    Price=Price,
-                    Volume=Volume
-                )
-                
-            case 400:
-                
-                raise ValueError(order_response.json()['detail']['Status']['Description']['en'])
-                
-            case _ :
-                
-                raise ValueError(order_response.text)
+        else : return None
         
     # +--------------------------------------------------------------------------------------+ #