bbstrader 0.3.0__py3-none-any.whl → 0.3.2__py3-none-any.whl

bbstrader/metatrader/account.py

@@ -1,7 +1,7 @@
 import os
 import re
 import urllib.request
-from datetime import datetime
+from datetime import datetime, timedelta
 from typing import Any, Dict, List, Literal, Optional, Tuple, Union
 
 import pandas as pd
@@ -54,9 +54,7 @@ BROKERS_TIMEZONES = {
     "PGL": "Europe/Helsinki",
 }
 
-_ADMIRAL_MARKETS_URL_ = (
-    "https://cabinet.a-partnership.com/visit/?bta=35537&brand=admiralmarkets"
-)
+_ADMIRAL_MARKETS_URL_ = "https://one.justmarkets.link/a/tufvj0xugm/registration/trader"
 _JUST_MARKETS_URL_ = "https://one.justmarkets.link/a/tufvj0xugm/registration/trader"
 _FTMO_URL_ = "https://trader.ftmo.com/?affiliates=JGmeuQqepAZLMcdOEQRp"
 _ADMIRAL_MARKETS_PRODUCTS_ = [
@@ -138,13 +136,13 @@ AMG_EXCHANGES = {
 }
 
 
-def check_mt5_connection(**kwargs):
+def check_mt5_connection(**kwargs) -> bool:
     """
     Initialize the connection to the MetaTrader 5 terminal.
 
     Args:
         path (str, optional): The path to the MetaTrader 5 terminal executable file.
-            Defaults to None (e.g., "C:\\Program Files\\MetaTrader 5\\terminal64.exe").
+            Defaults to None (e.g., "C:/Program Files/MetaTrader 5/terminal64.exe").
         login (int, optional): The login ID of the trading account. Defaults to None.
         password (str, optional): The password of the trading account. Defaults to None.
         server (str, optional): The name of the trade server to which the client terminal is connected.
@@ -165,6 +163,7 @@ def check_mt5_connection(**kwargs):
     timeout = kwargs.get("timeout", 60_000)
     portable = kwargs.get("portable", False)
 
+    init = False
     if path is None and (login or password or server):
         raise ValueError(
             "You must provide a path to the terminal executable file"
@@ -189,6 +188,7 @@ def check_mt5_connection(**kwargs):
             raise_mt5_error(INIT_MSG)
     except Exception:
         raise_mt5_error(INIT_MSG)
+    return init
 
 
 def shutdown_mt5():
@@ -391,6 +391,7 @@ class Account(object):
         password: Optional[str] = None,
         server: Optional[str] = None,
         timeout: Optional[int] = 60_000,
+        path: Optional[str] = None,
     ) -> Union[AccountInfo, None]:
         """
         Get info on the current trading account or a specific account .
@@ -408,6 +409,8 @@ class Account(object):
                  If not specified, the value of 60 000 (60 seconds) is applied.
                  If the connection is not established within the specified time,
                  the call is forcibly terminated and the exception is generated.
+            path (str, optional): The path to the MetaTrader 5 terminal executable file.
+                Defaults to None (e.g., "C:/Program Files/MetaTrader 5/terminal64.exe").
 
         Returns:
         -   AccountInfo in the form of a Namedtuple structure.
@@ -419,6 +422,15 @@ class Account(object):
         # connect to the trade account specifying a password and a server
         if account is not None and password is not None and server is not None:
             try:
+                # If a path is provided, initialize the MT5 terminal with it
+                if path is not None:
+                    check_mt5_connection(
+                        path=path,
+                        login=account,
+                        password=password,
+                        server=server,
+                        timeout=timeout,
+                    )
                 authorized = mt5.login(
                     account, password=password, server=server, timeout=timeout
                 )
@@ -760,10 +772,7 @@ class Account(object):
             This mthods works primarly with Admirals Group AS products and Pepperstone Group Limited,
             For other brokers use `get_symbols()` or this method will use it by default.
         """
-        if (
-            self.broker != AdmiralMarktsGroup()
-            or self.broker != PepperstoneGroupLimited()
-        ):
+        if self.broker not in [AdmiralMarktsGroup(), PepperstoneGroupLimited()]:
             return self.get_symbols(symbol_type=SymbolType.FOREX)
         else:
             fx_categories = {
@@ -816,11 +825,8 @@ class Account(object):
             This mthods works primarly with Admirals Group AS products and Pepperstone Group Limited,
             For other brokers use `get_symbols()` or this method will use it by default.
         """
-        
-        if (
-            self.broker != AdmiralMarktsGroup()
-            or self.broker != PepperstoneGroupLimited()
-        ):
+
+        if self.broker not in [AdmiralMarktsGroup(), PepperstoneGroupLimited()]:
             return self.get_symbols(symbol_type=SymbolType.STOCKS)
         else:
             stocks, etfs = [], []
@@ -883,7 +889,7 @@ class Account(object):
                 SymbolType.STOCKS, exchange_code, exchange_map
             )
             etfs = self._get_symbols_by_category(
-                    SymbolType.ETFs, exchange_code, exchange_map
+                SymbolType.ETFs, exchange_code, exchange_map
             )
             return stocks + etfs if etf else stocks
 
@@ -1085,6 +1091,39 @@ class Account(object):
         except Exception as e:
             raise_mt5_error(e)
 
+    def calculate_profit(
+        self,
+        action: Literal["buy", "sell"],
+        symbol: str,
+        lot: float,
+        price_open: float,
+        price_close: float,
+    ) -> float:
+        """
+        Calculate profit in the account currency for a specified trading operation.
+
+        Args:
+            action (str): The trading action, either 'buy' or 'sell'.
+            symbol (str): The symbol of the financial instrument.
+            lot (float): The lot size of the order.
+            price_open (float): The price at which to position was opened.
+            price_close (float): The price at which to position was closed.
+
+        Returns:
+            float: The profit value
+
+        Raises:
+            MT5TerminalError: A specific exception based on the error code.
+
+        """
+        actions = {"buy": mt5.ORDER_TYPE_BUY, "sell": mt5.ORDER_TYPE_SELL}
+        try:
+            return mt5.order_calc_profit(
+                actions[action], symbol, lot, price_open, price_close
+            )
+        except Exception as e:
+            raise_mt5_error(e)
+
     def check_order(self, request: Dict[str, Any]) -> OrderCheckResult:
         """
         Check funds sufficiency for performing a required trading operation.
@@ -1533,3 +1572,29 @@ class Account(object):
         else:
             history_orders = [TradeOrder(**td._asdict()) for td in history_orders]
             return tuple(history_orders)
+
+    def get_today_deals(self, id, group=None) -> List[TradeDeal]:
+        """
+        Get all today deals for a specific symbol or group of symbols
+
+        Args:
+            id (int): strategy or expert id
+            group (str): Symbol or group or symbol
+        Returns:
+            List[TradeDeal]: List of today deals
+        """
+        date_from = datetime.now() - timedelta(days=2)
+        history = (
+            self.get_trades_history(date_from=date_from, group=group, to_df=False) or []
+        )
+        positions_ids = set([deal.position_id for deal in history if deal.magic == id])
+        today_deals = []
+        for position in positions_ids:
+            deal = self.get_trades_history(
+                date_from=date_from, position=position, to_df=False
+            )
+            if deal is not None and len(deal) == 2:
+                deal_time = datetime.fromtimestamp(deal[1].time)
+                if deal_time.date() == datetime.now().date():
+                    today_deals.append(deal[1])
+        return today_deals