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

HedgeTech/EmsEngine/__tse_ifb/__AsyncClient.py

@@ -13,17 +13,31 @@ from HedgeTech.Auth import AuthAsyncClient
 from PIL.Image import open as image_open
 from PIL.ImageFile import ImageFile
 from io import BytesIO
+from asyncio import sleep
 
 # ========================================|======================================== #
 #                                 Class Definitions                                 #
 # ========================================|======================================== #
 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_AsyncClient` methods.
+    """
+    
     def __init__(
         self,
         *,
-        order_uuid : HexUUID,
+        SendOrder_RequestInfo : dict,
         AuthASyncClient : AuthAsyncClient,
+        SymbolNameOrIsin : str,
+        Price : int,
+        Volume :int,
         Order_ValidityType : Literal[
             'DAY',
             'GTC', # Good Till Cancelled
@@ -32,26 +46,99 @@ class Order:
             'FOK', # Fill Or Kill
         ] = 'DAY',
         ValidityDate : int = 0,
-        SymbolNameOrIsin : str,
-        Price : int,
-        Volume :int,
     ):
+
+        """
+        Represents a stock order in the EMS Engine for TSE IFB.
+
+        This class allows sending, editing, deleting, and checking the status
+        of a stock order using an asynchronous client.
+
+        Attributes
+        ----------
+        ValidityType : str
+            Type of order validity ('DAY', 'GTC', 'GTD', 'FAK', 'FOK').
+        ValidityDate : int
+            Expiration date of the order (for 'GTD' type).
+        SymbolNameOrIsin : str
+            Symbol name or ISIN code of the security.
+        Price : int
+            Order price.
+        Volume : int
+            Order volume.
+        is_deleted : bool
+            True if the order has been deleted.
+        OrderId : HexUUID | None
+            Unique identifier of the order after submission.
+
+        Methods
+        -------
+        send()
+            Sends the order asynchronously to the EMS engine.
+        Edit(Order_ValidityType, ValidityDate, Price, Volume)
+            Edits the existing order asynchronously.
+        Status()
+            Retrieves the current status of the order asynchronously.
+        Delete()
+            Deletes the order asynchronously.
+        """    
+    
         
         self.__AuthASyncClient = AuthASyncClient
-        self.__order_uuid : HexUUID = order_uuid
+        self.__SendOrder_RequestInfo = SendOrder_RequestInfo
+        
         self.ValidityType : str = Order_ValidityType
         self.ValidityDate : int = ValidityDate
         self.SymbolNameOrIsin : str = SymbolNameOrIsin
         self.Price : int = Price 
         self.Volume : int = Volume
         self.is_deleted : bool = False
-        
+
+        self.OrderId : HexUUID | None = None   
 
     # +--------------------------------------------------------------------------------------+ #
     
+    async def send(self)-> None:
+        
+        """
+        Sends the order to the EMS engine asynchronously.
+
+        If the order has not been sent before, it posts the request
+        using the provided AuthAsyncClient.
+
+        Returns
+        -------
+        None
+
+        Example
+        -------
+        >>> order = await client.Buy_by_Name(symbolName="اطلس", Price=100000, Volume=10)
+        >>> await order.send()
+        >>> print(order.OrderId)
+        '953097ac6ced45ca8ef205b76ca6faf2'
+        """
+        
+        if self.OrderId is None : 
+        
+            SendOrder_Response = await self.__AuthASyncClient.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
+        
+    # +--------------------------------------------------------------------------------------+ #
     async def Edit(
         self,
         *,
+        Price : int,
+        Volume :int,
         Order_ValidityType : Literal[
             'DAY',
             'GTC', # Good Till Cancelled
@@ -60,121 +147,214 @@ class Order:
             'FOK', # Fill Or Kill
         ] = 'DAY',
         ValidityDate : int = 0,
-        Price : int,
-        Volume :int,
     )-> None:
         
-        Edit_response = await self.__AuthASyncClient.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:
+        """
+        Edits an existing order asynchronously.
+
+        Parameters
+        ----------
+        Order_ValidityType : str
+            The new order validity type.
+        ValidityDate : int
+            New expiration date if validity type is 'GTD'.
+        Price : int
+            New order price.
+        Volume : int
+            New order volume.
+
+        Returns
+        -------
+        None
+
+        Example
+        -------
+        >>> await order.Edit(Price=105, Volume=15)
+        """
+        
+        if self.OrderId is not None: 
+        
+            Edit_response = await self.__AuthASyncClient.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
-    async def Status(self)-> OrderStatus:
-        
-        status_respnse = await self.__AuthASyncClient.httpx_Client.get(
-            url='https://core.hedgetech.ir/ems-engine/tse-ifb/order/status',
-            params={'order_uuid' : self.__order_uuid}
-        )
+
+    async def Status(self)-> OrderStatus | None:
         
-        match status_respnse.status_code :
+        """
+        Retrieves the current status of the order asynchronously.
+
+        Returns
+        -------
+        OrderStatus | None
+            A dictionary containing the current order status with the following keys:
+                - order_uuid: HexUUID, unique identifier of the order.
+                - order_status: 'InQueue' | 'Cancelled' | 'Broken' | 'Settled'
+                - Price: int, the order price.
+                - Volume: int, the original order volume.
+                - RemainedVolume: int, volume remaining unexecuted.
+                - ExecutedVolume: int, executed volume.
+                - OrderSide: 'Buy' | 'Sell', the order side.
+                - ValidityType: 'DAY' | 'GTC' | 'GTD', the type of order validity.
+                - ValidityDate: int, expiration date if applicable.
+
+        Example
+        -------
+        >>> status = await order.Status()
+        >>> print(status)
+        {
+            'order_uuid': '953097ac6ced45ca8ef205b76ca6faf2',
+            'order_status': 'InQueue',
+            'Price': 100,
+            'Volume': 10,
+            'RemainedVolume': 10,
+            'ExecutedVolume': 0,
+            'OrderSide': 'Buy',
+            'ValidityType': 'DAY',
+            'ValidityDate': 0
+        }
+        """
+        
+        if self.OrderId is not None:  
+        
+            status_respnse = await self.__AuthASyncClient.httpx_Client.get(
+                url='https://core.hedgetech.ir/ems-engine/tse-ifb/order/status',
+                params={'order_uuid' : self.OrderId}
+            )
             
-            case 200:
+            match status_respnse.status_code :
                 
-                return status_respnse.json()['Data']
+                case 200:
+                    
+                    return status_respnse.json()['Data']
+                    
+                case _ : return None
                 
-            case 400:
-                
-                raise ValueError(status_respnse.json()['detail']['Status']['Description']['en'])
-
-            case _ :
-                
-                raise ValueError(status_respnse.text)
-            
-    # +--------------------------------------------------------------------------------------+ #
-    
-    @property
-    async def order_is_valid(self)-> bool:
-        
-        status = await self.Status
-        
-        if (status['Price'] == self.Price) and (
-            status['Volume'] == self.Volume
-        ) and (status['ValidityType'] == self.ValidityType) and status['OrderInQueue']:
+        else : return None
             
-            return True
-        
-        else : return False
-    
     # +--------------------------------------------------------------------------------------+ #
     
-    @property
-    async def Delete(self)-> bool :
-        
-        Delete_respnse =  await self.__AuthASyncClient.httpx_Client.delete(
-            url= 'https://core.hedgetech.ir/ems-engine/tse-ifb/order/delete',
-            params={'order_uuid' : self.__order_uuid}
-        )
+    async def Delete(self)-> None:
         
+        """
+        Deletes the order asynchronously.
+
+        Sets `is_deleted` to True if successful.
 
-        match Delete_respnse.status_code :
+        Returns
+        -------
+        None
+
+        Example
+        -------
+        >>> await order.Delete()
+        >>> print(order.is_deleted)
+        True
+        """
+                
+        if self.OrderId is not None:  
+        
+            Delete_respnse =  await self.__AuthASyncClient.httpx_Client.delete(
+                url= 'https://core.hedgetech.ir/ems-engine/tse-ifb/order/delete',
+                params={'order_uuid' : self.OrderId}
+            )
             
-            case 200:
-                
-                self.is_deleted = True
-                
-            case 400:
-                
-                raise ValueError(Delete_respnse.json()['detail']['Status']['Description']['en'])
-        
-            case _ :
-                
-                raise ValueError(Delete_respnse.text)
+
+            match Delete_respnse.status_code :
+                
+                case 200:
+                    
+                    self.is_deleted = True
+                    return None
+                            
+                case _ : return None
     
+        else : return None
 
 # ================================================================================= #
 
-class EmsEngine_TseIfb_ASyncClient:
+class EmsEngine_TseIfb_AsyncClient:
+    
+    """
+    Asynchronous EMS Engine client for TSE/IFB markets.
+
+    This client manages authentication, OMS login,
+    and order creation.
+    """
     
     def __init__(
         self,
         AuthASyncClient : AuthAsyncClient,
     ):
-        
+      
+        """
+        Asynchronous client for interacting with the EMS Engine (TSE IFB).
+
+        Provides methods for logging in, retrieving CAPTCHA, and creating buy/sell orders
+        by symbol name or ISIN.
+
+        Attributes
+        ----------
+        Customer_FullName : str | None
+            Full name of the logged-in customer.
+        Customer_TSEBourseCode : str | None
+            TSE bourse code of the customer.
+        oms_session : HexUUID | None
+            Session token obtained after login.
+
+        Methods
+        -------
+        Get_Captcha(OMS)
+            Retrieves the login CAPTCHA image asynchronously.
+            
+        oms_login(username, password, captcha_value)
+            Logs into the OMS asynchronously.
+            
+        Buy_by_Name(Order_ValidityType, ValidityDate, symbolName, Price, Volume)
+            Creates a new buy order by symbol name asynchronously.
+            
+        Sell_by_Name(Order_ValidityType, ValidityDate, symbolName, Price, Volume)
+            Creates a new sell order by symbol name asynchronously.
+            
+        Buy_by_isin(Order_ValidityType, ValidityDate, symbolIsin, Price, Volume)
+            Creates a new buy order by ISIN asynchronously.
+            
+        Sell_by_isin(Order_ValidityType, ValidityDate, symbolIsin, Price, Volume)
+            Creates a new sell order by ISIN asynchronously.
+        """  
         
         self.__AuthASyncClient = AuthASyncClient
         
         self.Customer_FullName : str | None = None
         self.Customer_TSEBourseCode : str | None = None
-        self.oms_session : str | None = None
+        self.oms_session : HexUUID | None = None
         
     # +--------------------------------------------------------------------------------------+ #
     
@@ -187,6 +367,30 @@ class EmsEngine_TseIfb_ASyncClient:
         ]
     )-> ImageFile:
         
+        """
+        Retrieves the CAPTCHA image for the specified OMS asynchronously.
+
+        Parameters
+        ----------
+        OMS : str
+            OMS identifier ('Omex | Parsian' or 'Sahra | Karamad').
+
+        Returns
+        -------
+        ImageFile
+            The CAPTCHA image object.
+
+        Raises
+        ------
+        ValueError
+            If the request fails or returns an error.
+
+        Example
+        -------
+        >>> captcha = await client.Get_Captcha('Omex | Parsian')
+        >>> captcha.show()
+        """
+        
         Captcha = await self.__AuthASyncClient.httpx_Client.get(
             url='https://core.hedgetech.ir/ems-engine/tse-ifb/oms/login',
             params={'oms' : OMS }
@@ -205,6 +409,34 @@ class EmsEngine_TseIfb_ASyncClient:
         password: str,
         captcha_value: str,
     ) -> None :
+        
+        """
+        Logs into the OMS asynchronously with provided credentials and CAPTCHA.
+
+        Parameters
+        ----------
+        username : str
+            OMS username.
+        password : str
+            OMS password.
+        captcha_value : str
+            Solved CAPTCHA value.
+
+        Returns
+        -------
+        None
+
+        Raises
+        ------
+        ValueError
+            If login fails or CAPTCHA is invalid.
+
+        Example
+        -------
+        >>> await client.oms_login("user123", "pass123", "abcd")
+        >>> print(client.oms_session)
+        'session_token_here'
+        """
 
         response = await self.__AuthASyncClient.httpx_Client.post(
             url='https://core.hedgetech.ir/ems-engine/tse-ifb/oms/login',
@@ -241,6 +473,9 @@ class EmsEngine_TseIfb_ASyncClient:
     async def Buy_by_Name(
         self,
         *,
+        symbolName : str,
+        Price : int,
+        Volume :int,
         Order_ValidityType : Literal[
             'DAY',
             'GTC', # Good Till Cancelled
@@ -249,55 +484,70 @@ class EmsEngine_TseIfb_ASyncClient:
             'FOK', # Fill Or Kill
         ] = 'DAY',
         ValidityDate : int = 0,
-        symbolName : str,
-        Price : int,
-        Volume :int,
-    )-> Order:
+    )-> Order | None:
         
-        order_response = await self.__AuthASyncClient.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:
-            
-            
-            case 200:
-                
-                order_response = order_response.json()
-                
-                return Order(
-                    order_uuid=order_response['Data']['order_uuid'],
-                    AuthSyncClient=self.__AuthASyncClient,
-                    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)
-                        
+        """
+        Creates a new buy order by symbol name asynchronously.
+
+        Parameters
+        ----------
+        Order_ValidityType : str
+            Order validity type.
+        ValidityDate : int
+            Expiration date if validity type is 'GTD'.
+        symbolName : str
+            Symbol name of the security.
+        Price : int
+            Order price.
+        Volume : int
+            Order volume.
+
+        Returns
+        -------
+        Order | None
+            A new Order instance if OMS session exists, else None.
 
+        Example
+        -------
+        >>> order = await client.Buy_by_Name(symbolName="اطلس", Price=100000, Volume=10)
+        >>> await order.send()
+        """
+        
+        await sleep(0)
+        
+        if self.oms_session is not None: 
+        
+            return Order(
+                AuthASyncClient=self.__AuthASyncClient,
+                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
+                    }
+                }
+            )
+            
+        else : return None
+        
     # +--------------------------------------------------------------------------------------+ #
     
     
     async def Sell_by_Name(
         self,
         *,
+        symbolName : str,
+        Price : int,
+        Volume :int,
         Order_ValidityType : Literal[
             'DAY',
             'GTC', # Good Till Cancelled
@@ -306,53 +556,69 @@ class EmsEngine_TseIfb_ASyncClient:
             'FOK', # Fill Or Kill
         ] = 'DAY',
         ValidityDate : int = 0,
-        symbolName : str,
-        Price : int,
-        Volume :int,
-    )-> Order:
+    )-> Order | None:
         
-        order_response = await self.__AuthASyncClient.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
-            }
-        )
+        """
+        Creates a new sell order by symbol name asynchronously.
+
+        Parameters
+        ----------
+        Order_ValidityType : str
+            Order validity type.
+        ValidityDate : int
+            Expiration date if validity type is 'GTD'.
+        symbolName : str
+            Symbol name of the security.
+        Price : int
+            Order price.
+        Volume : int
+            Order volume.
+
+        Returns
+        -------
+        Order | None
+            A new Order instance if OMS session exists, else None.
+
+        Example
+        -------
+        >>> order = await client.Sell_by_Name(symbolName="اطلس", Price=100000, Volume=10)
+        >>> await order.send()
+        """
+        
+        await sleep(0)
         
-        match order_response.status_code:
+        if self.oms_session is not None: 
             
+            return Order(
+                AuthASyncClient=self.__AuthASyncClient,
+                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.__AuthASyncClient,
-                    Order_ValidityType=Order_ValidityType,
-                    ValidityDate=ValidityDate,
-                    SymbolNameOrIsin = symbolName,
-                    Price=Price,
-                    Volume=Volume
-                )
-                
-            case 400:
-                
-                raise ValueError(order_response.json()['detail']['Status']['Description']['en'])
-                
-            case _ :
+        else : return None
                 
-                raise ValueError(order_response.text)
-        
     # +--------------------------------------------------------------------------------------+ #
 
     async def Buy_by_isin(
         self,
         *,
+        symbolIsin : str,
+        Price : int,
+        Volume :int,
         Order_ValidityType : Literal[
             'DAY',
             'GTC', # Good Till Cancelled
@@ -361,54 +627,69 @@ class EmsEngine_TseIfb_ASyncClient:
             'FOK', # Fill Or Kill
         ] = 'DAY',
         ValidityDate : int = 0,
-        symbolIsin : str,
-        Price : int,
-        Volume :int,
-    )-> Order:
+    )-> Order | None:
         
-        order_response = await self.__AuthASyncClient.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
-            }
-        )
+        """
+        Creates a new buy order by symbol isin asynchronously.
+
+        Parameters
+        ----------
+        Order_ValidityType : str
+            Order validity type.
+        ValidityDate : int
+            Expiration date if validity type is 'GTD'.
+        symbolIsin : str
+            Symbol name of the security.
+        Price : int
+            Order price.
+        Volume : int
+            Order volume.
+
+        Returns
+        -------
+        Order | None
+            A new Order instance if OMS session exists, else None.
+
+        Example
+        -------
+        >>> order = await client.Buy_by_isin(symbolIsin="اطلس", Price=100000, Volume=10)
+        >>> await order.send()
+        """
         
-        match order_response.status_code:
-            
+        await sleep(0)    
+    
+        if self.oms_session is not None: 
             
-            case 200:
-                
-                order_response = order_response.json()
-                
-                return Order(
-                    order_uuid=order_response['Data']['order_uuid'],
-                    AuthSyncClient=self.__AuthASyncClient,
-                    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)
-        
+            return Order(
+                AuthASyncClient=self.__AuthASyncClient,
+                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
+                    }
+                }
+            )
+                
+        else : return None
         
     # +--------------------------------------------------------------------------------------+ #
     
     async def Sell_by_isin(
         self,
         *,
+        symbolIsin : str,
+        Price : int,
+        Volume :int,
         Order_ValidityType : Literal[
             'DAY',
             'GTC', # Good Till Cancelled
@@ -417,47 +698,60 @@ class EmsEngine_TseIfb_ASyncClient:
             'FOK', # Fill Or Kill
         ] = 'DAY',
         ValidityDate : int = 0,
-        symbolIsin : str,
-        Price : int,
-        Volume :int,
-    )-> Order:
+    )-> Order | None:
         
-        order_response = await self.__AuthASyncClient.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
-            }
-        )
-        
-        match order_response.status_code:
-            
-            
-            case 200:
-                
-                order_response = order_response.json()
-                
-                return Order(
-                    order_uuid=order_response['Data']['order_uuid'],
-                    AuthSyncClient=self.__AuthASyncClient,
-                    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)
+        """
+        Creates a new sell order by symbol isin asynchronously.
+
+        Parameters
+        ----------
+        Order_ValidityType : str
+            Order validity type.
+        ValidityDate : int
+            Expiration date if validity type is 'GTD'.
+        symbolIsin : str
+            Symbol name of the security.
+        Price : int
+            Order price.
+        Volume : int
+            Order volume.
+
+        Returns
+        -------
+        Order | None
+            A new Order instance if OMS session exists, else None.
+
+        Example
+        -------
+        >>> order = await client.Sell_by_isin(symbolIsin="اطلس", Price=100000, Volume=10)
+        >>> await order.send()
+        """
+        
+        await sleep(0)
+        
+        if self.oms_session is not None: 
+        
+            return Order(
+                AuthASyncClient=self.__AuthASyncClient,
+                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
+                    }
+                }
+            )
+        
+        else : return None
         
     # +--------------------------------------------------------------------------------------+ #