Comprehensive Guide to Managing Positions in MetaTrader 5 with Python: Automation and Insights

Watch on YouTube: Accessing Positions in MetaTrader 5 Using Python

MetaTrader 5 (MT5) provides programmatic access to your trading positions. Two key functions that every trader should understand are positions_total and positions_get. These functions allow you to monitor and retrieve detailed information about your current open positions, enabling better control over your trading strategies.

1. Counting Open Positions (positions_total)

The positions_total function returns the total number of open positions in the trading account. This includes all positions across various symbols and trading instruments.

Why It’s Useful

• Monitor the number of active positions at any time.
• Use it to enforce rules or constraints in your trading strategy (e.g., limit the number of open positions).

Example

Here’s how you can use positions_total to get the number of open positions:

import MetaTrader5 as mt5
# Initialize connection to MT5 (use your demo account credentials)
if not mt5.initialize(login=52021XXX, server="XXX-Demo", password="G3wt9SY&4wXXXX"):
    print("Failed to connect to MetaTrader 5, error code:", mt5.last_error())
    quit()
# Get the total number of open positions
total_positions = mt5.positions_total()
print(f"Total open positions: {total_positions}")

This function returns an integer indicating the number of currently active positions.

For the following examples, we will assume that the MetaTrader5 package has been imported, and the connection has been successfully initialized.

2. Retrieving Details of Open Positions (positions_get)

The positions_get function retrieves comprehensive information about all open positions. The returned data is provided as a tuple, containing detailed attributes such as symbol, volume, profit, and price.

Why It’s Useful

• Fetch specific details about your open positions for analysis.
• Filter positions based on criteria such as symbol, or magic number.
• Integrate this data into your trading logic or reports.

Example

Here’s how you can retrieve and display information about all open positions:

# Retrieve all open positions
positions = mt5.positions_get()
if positions is None:
    print("Failed to retrieve position data, error code:", mt5.last_error())
else:
    print(f"Retrieved {len(positions)} positions:")
    for position in positions:
        print(position)  # Each position with detailed attributes

To access specific attributes of positions, you can use the following code:

# Retrieve all open positions
positions = mt5.positions_get()
if positions is None:
    print("Failed to retrieve position data, error code:", mt5.last_error())
else:
    print(f"Retrieved {len(positions)} positions:")
    for position in positions:        
        print("Symbol: ", position.symbol)
        print("Open Price ", position.price_open)
        print("Profit: ", position.profit)

Filtering Example

You can filter positions for a specific symbol using the group parameter. For example, you can retrieve symbols that include “EUR” in their names by using the asterisk symbol ("*EUR*").

# Retrieve positions for the symbol "EUR"
positions = mt5.positions_get(group="*EUR*")
if positions:
    print(f"Open positions for EUR: {len(positions)}")
    for position in positions:
        print("Position symbol: ", position.symbol)
        print("Position profit: ", position.profit)

Key Attributes in positions_get

Each position contains several useful attributes. Some of the most commonly used are:

• symbol: The trading instrument (e.g., EURUSD).
• volume: The lot size of the position.
• price_open: The opening price of the position.
• profit: The current profit or loss of the position.
• magic: The magic number used to identify the strategy or EA that opened the position.
• sl and tp: Stop Loss and Take Profit levels, respectively.

Tips and Best Practices

1. Error Handling:
   • Always check if positions_get returns None to handle cases with no open positions.
   • Use clear error messages to debug issues effectively.
2. Filter for Efficiency:
   • Use the group parameter in positions_get to filter results and avoid processing unnecessary data.
3. Data Storage:
   • Store retrieved position data in a structured format (e.g., Pandas DataFrame) for advanced analysis and visualization.

Conclusion

The positions_total and positions_get functions are indispensable for monitoring and managing open positions in MetaTrader 5. Whether you’re implementing a simple strategy or developing a complex trading system, these functions provide the necessary tools to stay informed and in control.

In the next post, we’ll explore how to access history orders and deals. Stay tuned to enhance your algorithmic trading skills with Python and MetaTrader 5!

Next: Trading History

Previous: Orders