دليل إعداد Python مع MetaTrader 5 والوسيط: تكامل آمن يبدأ بالحساب التجريبي

مثال

نشرت Exness مادة تعليمية عن Python وMT5 تستخدم بيانات دخول MT5 ورمزاً خاصاً بالحساب مثل XAUUSDm. المثال يوضح سير العمل عبر المنصة، لكنه لا يعني أن كل حساب لدى Exness يحمل اسم الخادم أو اللاحقة نفسها. وتؤكد صفحة XM الرسمية دعم المستشارين الخبراء على MT5؛ وهذه معلومة مرتبطة بالأتمتة، مع ضرورة التمييز بين تكامل Python وبرامج EA المكتوبة بلغة MQL5.

مثال

يرفض المثال التالي أي حساب غير تجريبي ويغلق الاتصال في جميع الحالات:

import os
import MetaTrader5 as mt5
from dotenv import load_dotenv

load_dotenv()
login = int(os.environ["MT5_LOGIN"])

if not mt5.initialize(
    os.environ["MT5_PATH"],
    login=login,
    password=os.environ["MT5_PASSWORD"],
    server=os.environ["MT5_SERVER"],
    timeout=60_000,
):
    raise RuntimeError(f"MT5 initialize failed: {mt5.last_error()}")

try:
    terminal = mt5.terminal_info()
    account = mt5.account_info()
    if terminal is None or account is None:
        raise RuntimeError(f"MT5 state unavailable: {mt5.last_error()}")
    if account.login != login:
        raise RuntimeError("Connected account does not match configuration")
    if os.getenv("MT5_EXPECT_DEMO", "true").lower() == "true" and account.trade_mode != mt5.ACCOUNT_TRADE_MODE_DEMO:
        raise RuntimeError("Safety stop: account is not demo")
    print({"login": account.login, "server": account.server, "connected": terminal.connected})
finally:
    mt5.shutdown()

لا يكفي نجاح initialize() لإثبات صحة البيئة؛ فالتحقق اللاحق هو الذي يمنع استخدام الحساب الخطأ.

مثال

from datetime import datetime, timezone
import pandas as pd
import MetaTrader5 as mt5

matches = mt5.symbols_get(group="*EURUSD*") or ()
print([item.name for item in matches])  # اختر رمز الحساب التجريبي يدوياً

symbol = "EURUSD"  # استبدله بعد الاكتشاف
if not mt5.symbol_select(symbol, True):
    raise RuntimeError(f"Cannot select {symbol}: {mt5.last_error()}")

info = mt5.symbol_info(symbol)
tick = mt5.symbol_info_tick(symbol)
account = mt5.account_info()
rates = mt5.copy_rates_from(
    symbol, mt5.TIMEFRAME_M15, datetime.now(timezone.utc), 200
)
if info is None or tick is None or account is None or rates is None or len(rates) == 0:
    raise RuntimeError(f"Missing MT5 data: {mt5.last_error()}")

frame = pd.DataFrame(rates)
frame["time"] = pd.to_datetime(frame["time"], unit="s", utc=True)
print(frame[["time", "open", "high", "low", "close", "spread"]].tail())
print({"balance": account.balance, "equity": account.equity, "bid": tick.bid, "ask": tick.ask})

اعتبر السعر قديماً إذا تجاوز طابعه الزمني الحد الذي وثقته لساعات السوق. تحتاج عطلات نهاية الأسبوع والإجازات وفترات توقف الأداة إلى قواعد مختلفة عن الجلسة النشطة.

مثال

import os
import MetaTrader5 as mt5

def guarded_demo_buy(symbol: str, daily_pnl: float, max_daily_loss: float = 50.0):
    account = mt5.account_info()
    info = mt5.symbol_info(symbol)
    tick = mt5.symbol_info_tick(symbol)
    if account is None or info is None or tick is None:
        raise RuntimeError(f"State unavailable: {mt5.last_error()}")
    if account.trade_mode != mt5.ACCOUNT_TRADE_MODE_DEMO:
        raise RuntimeError("Blocked: demo accounts only")
    if os.getenv("MT5_KILL_SWITCH", "false").lower() == "true":
        raise RuntimeError("Blocked: kill switch active")
    if daily_pnl <= -abs(max_daily_loss):
        raise RuntimeError("Blocked: maximum daily loss reached")
    if mt5.positions_get(symbol=symbol):
        raise RuntimeError("Blocked: existing symbol position")
    if not mt5.symbol_select(symbol, True):
        raise RuntimeError(f"Symbol unavailable: {mt5.last_error()}")

    request = {
        "action": mt5.TRADE_ACTION_DEAL,
        "symbol": symbol,
        "volume": info.volume_min,
        "type": mt5.ORDER_TYPE_BUY,
        "price": tick.ask,
        "deviation": 10,
        "magic": 26091001,
        "comment": "FTL_DEMO_TEST",
        "type_time": mt5.ORDER_TIME_GTC,
        "type_filling": mt5.ORDER_FILLING_RETURN,  # تحقق من دعم الوسيط
    }
    checked = mt5.order_check(request)
    if checked is None or checked.retcode != 0:
        raise RuntimeError(f"order_check rejected: {checked}; {mt5.last_error()}")

    if os.getenv("MT5_ALLOW_ORDER_SEND", "false").lower() != "true":
        return {"sent": False, "reason": "dry run", "check": checked._asdict()}

    result = mt5.order_send(request)
    if result is None or result.retcode != mt5.TRADE_RETCODE_DONE:
        raise RuntimeError(f"order_send failed: {result}; {mt5.last_error()}")
    return {"sent": True, "deal": result.deal, "order": result.order}

لا تحسب الدالة استراتيجية أو مسافة وقف أو مخاطرة ملائمة، وحد الخسارة النقدي فيها تعليمي فقط. في أداة اختبار فعلية، احسب الحجم من وقف مُراجع باستخدام أداة حجم العقد والمخاطرة، وطابقه مع volume_step إلى الأسفل؛ لا ترفعه بما يزيد المخاطرة.

مثال

تكتب خدمة آمنة سجلات JSON تشمل وقت UTC وإصدار الاستراتيجية وبصمة غير عكسية للحساب والرمز والقرار ومعرف الطلب ورمز الفحص ورمز الإرسال والكمون، من دون أسرار. ينبه مراقب الصحة عند غياب النبض، لكنه لا يشغّل نسخاً متعددة آلياً. وبعد إعادة التشغيل، تطابق الخدمة المراكز والربح والخسارة اليومية، ثم تبدأ في وضع المحاكاة حتى تنجح فحوص الصحة.