Skip to content

Your First Project in 10 Minutes (Python)¶

Hands-on Quick Start - Create a working trading project with MetaTrader 5 and PyMT5 from scratch.

Step 0: Obtain Your API Key¶

To connect to MetaRPC endpoints (mt5.mrpc.pro:443), obtain your API key:

  1. Register for free at https://mrpc.pro/signup.
  2. Generate your API token in your dashboard at https://mrpc.pro/my.
  3. Set your token in your environment or connection config.

Step 1: Create Your Project¶

Create a new directory for your trading bot:

mkdir my_pymt5_bot
cd my_pymt5_bot

Install the package:

pip install metarpc-mt5

Step 2: Write Your Trading Code¶

Create your main application file and paste the following snippet:

from pymt5 import MT5Account

# Session ID generation on Connect and authentication are handled automatically
account = MT5Account(user=user, password=password, host=grpc_server, api_key=api_key)
await account.connect_by_server_name(server_name, "EURUSD", timeout=30)
summary = await account.account_summary()
print(f"Balance: {summary.account_balance}, Equity: {summary.account_equity}")

Step 3: Run the Program¶

Run your application:

# Verify connection output
# Balance: 10000.00, Equity: 10000.00

🚀 Next Steps¶

Congratulations! You have successfully established a direct gRPC connection to MetaTrader 5. Next:

  • Explore gRPC Streaming to listen to live ticks.
  • Check the API Reference for all 40+ available terminal methods.
  • Learn about high-level risk management and auto-normalization in MT5Sugar.