Exploring Account Information in MetaTrader 5 with Python

Watch on YouTube: Retrieving & Understanding Account Information in MT5 with Python

MetaTrader 5 (MT5) provides detailed account information that traders can use to monitor and analyze their trading activities. With Python and the MetaTrader 5 package, accessing this data becomes simple and programmatic. In this post, we’ll walk you through how to fetch and interpret account information from MT5 using Python.

Why Access Account Information?

Understanding your account metrics is critical for managing risk and ensuring successful trading. Account information includes:

• Account balance and equity.
• Margin usage and free margin.
• Leverage and profit.
• Trading account status (e.g., account currency, broker details).

These metrics help traders:

• Monitor real-time account health.
• Assess margin levels to avoid margin calls.
• Track profits and losses programmatically.

Accessing Account Information Using Python

To fetch account information from MetaTrader 5, we use the account_info() function provided by the MetaTrader 5 package. The function returns information in the form of a named tuple (namedtuple) structure.

Code Example

Here’s how to connect to your MT5 account and retrieve account information:

import MetaTrader5 as mt5
# Initialize connection to MT5 (use your demo account credentials)
if not mt5.initialize(login=52021XXX, server="XXX-Demo", password="G3wt9SYXXX"):
    print("Failed to connect to MetaTrader 5, error code:", mt5.last_error())
    quit()
# Fetch account information
account_info = mt5.account_info()
if account_info is None:
    print("Failed to retrieve account information, error code:", mt5.last_error())
else:
    # Print account information
    print("Account Information:")
    print(f"Balance: {account_info.balance}")
    print(f"Equity: {account_info.equity}")
    print(f"Margin: {account_info.margin}")
    print(f"Free Margin: {account_info.margin_free}")
    print(f"Profit: {account_info.profit}")
    print(f"Leverage: {account_info.leverage}")
    print(f"Currency: {account_info.currency}")
    print(f"Server: {account_info.server}")
    # save all account information into a dictionary
    account_info_dict = account_info._asdict()    
# Shutdown MT5 connection
# mt5.shutdown() # terminate connection 

Code Breakdown

1. Connection Initialization:
   • The mt5.initialize() method connects Python to your MT5 terminal.
   • Replace the login, server, and password parameters with your account details.
2. Retrieve Account Information:
   • mt5.account_info() fetches all account-related metrics.
   • Returns an Account_Info object with attributes like balance, equity, margin, etc.
3. Error Handling:
   • If the function fails, use mt5.last_error() to debug.
4. Account Metrics:
   • Balance: Total funds in the account.
   • Equity: Current account balance, including unrealized profits/losses.
   • Margin: Amount locked in open positions.
   • Free Margin: Funds available for new trades.
   • Profit: Total profit or loss from all open trades.
   • Leverage: The leverage ratio set by the broker.
   • Currency: The account’s base currency.
   • Server: The server’s name
5. Save Dictionary with Account Information:
   • Define a variable account_info_dict to store all available account details as a dictionary using the account_info._asdict() method.
6. Shut Down Connection:
   • Always terminate the connection with mt5.shutdown() after completing the operations.

Practical Use Cases

• Risk Management: Calculate free margin and ensure it’s sufficient before placing new trades.
• Performance Tracking: Track equity and profit changes programmatically.
• Alerts and Automation: Send alerts when account metrics fall below predefined thresholds (e.g., low free margin).

Conclusion

Using Python and the MetaTrader 5 package, you can access detailed account information to monitor and manage your trading activities effectively. Using a similar code structure, you can retrieve terminal information with the terminal_info() function.

In the next post, we’ll explore how to work with symbol data programmatically. Stay tuned!

Next: Symbol Features

Previous: Installation and Initialization