Skip to content

Utilities

Utility module for MetaTrader 5 integration.

Provides helper functions and classes for trading operations.

Utilities #

Utilities()

A utility class for handling trading-related functionalities.

Source code in mqpy\utilities.py 
25
26
27
28
29
30
31
32
def __init__(self) -> None:
    """Initialize the Utilities class."""
    # Variables for minutes_counter
    self.__minutes_counter: int = 0
    self.__counter_flag: bool = True
    self.__allowed_to_trade: bool = True
    self.__allow_to_count: bool = False
    self.__recent_trade: bool = False

check_trade_availability #

check_trade_availability(symbol, count_until)

Check if trading is allowed based on specified conditions.

Parameters:

Name Type Description Default
symbol str

The financial instrument symbol.

 required
count_until int

The number of minutes until trading is allowed.

 required

Returns:

Name Type Description
bool bool

True if trading is allowed, False otherwise.
Source code in mqpy\utilities.py 
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
def check_trade_availability(self, symbol: str, count_until: int) -> bool:
    """Check if trading is allowed based on specified conditions.

    Args:
        symbol (str): The financial instrument symbol.
        count_until (int): The number of minutes until trading is allowed.

    Returns:
        bool: True if trading is allowed, False otherwise.
    """
    if len(Mt5.positions_get(symbol=symbol)) == 1:
        self.__recent_trade = True

    if len(Mt5.positions_get(symbol=symbol)) != 1 and self.__recent_trade and not self.__allow_to_count:
        self.__allow_to_count = True
        self.__allowed_to_trade = False

    if datetime.now(timezone.utc).second == 0 and self.__counter_flag and self.__allow_to_count:
        logger.info(f"Trading will be allowed in {count_until - self.__minutes_counter} minutes.")
        self.__minutes_counter += 1
        self.__counter_flag = False

    if datetime.now(timezone.utc).second == 59:
        self.__counter_flag = True

    if self.__minutes_counter == count_until:
        logger.info("Trading is allowed.\n")
        self.__reset_counters()

    return self.__allowed_to_trade

__reset_counters #

__reset_counters()

Reset counters after trading is allowed.

Source code in mqpy\utilities.py 
65
66
67
68
69
70
def __reset_counters(self) -> None:
    """Reset counters after trading is allowed."""
    self.__minutes_counter = 0
    self.__counter_flag = True
    self.__allow_to_count = False
    self.__allowed_to_trade = True