mt5-mac 0.1.0__py3-none-any.whl

mt5_mac/__init__.py

@@ -0,0 +1,277 @@
+from __future__ import annotations
+
+__version__ = "0.1.0"
+__author__ = "Abdul Rafay Jiwani"
+__email__ = "abdulrafayjiwani@proton.me"
+__license__ = "MIT"
+
+from mt5_mac.backend import MT5Backend
+from mt5_mac.types import (
+    MqlTick, MqlRates, MqlAccountInfo, MqlSymbolInfo,
+    MqlTradeRequest, MqlTradeResult, MqlPosition, MqlOrder, MqlDeal,
+)
+
+_backend: MT5Backend | None = None
+
+# Timeframes
+TIMEFRAME_M1 = 1
+TIMEFRAME_M2 = 2
+TIMEFRAME_M3 = 3
+TIMEFRAME_M4 = 4
+TIMEFRAME_M5 = 5
+TIMEFRAME_M6 = 6
+TIMEFRAME_M10 = 10
+TIMEFRAME_M12 = 12
+TIMEFRAME_M15 = 15
+TIMEFRAME_M20 = 20
+TIMEFRAME_M30 = 30
+TIMEFRAME_H1 = 60
+TIMEFRAME_H2 = 120
+TIMEFRAME_H3 = 180
+TIMEFRAME_H4 = 240
+TIMEFRAME_H6 = 360
+TIMEFRAME_H8 = 480
+TIMEFRAME_H12 = 720
+TIMEFRAME_D1 = 1440
+TIMEFRAME_W1 = 10080
+TIMEFRAME_MN1 = 43200
+
+# Trade actions
+TRADE_ACTION_DEAL = 1
+TRADE_ACTION_PENDING = 5
+TRADE_ACTION_SLTP = 2
+TRADE_ACTION_MODIFY = 7
+TRADE_ACTION_REMOVE = 6
+TRADE_ACTION_CLOSE_BY = 3
+
+# Order types
+ORDER_TYPE_BUY = 0
+ORDER_TYPE_SELL = 1
+ORDER_TYPE_BUY_LIMIT = 2
+ORDER_TYPE_SELL_LIMIT = 3
+ORDER_TYPE_BUY_STOP = 4
+ORDER_TYPE_SELL_STOP = 5
+ORDER_TYPE_BUY_STOP_LIMIT = 6
+ORDER_TYPE_SELL_STOP_LIMIT = 7
+ORDER_TYPE_CLOSE_BY = 8
+
+# Order filling
+ORDER_FILLING_FOK = 0
+ORDER_FILLING_IOC = 1
+ORDER_FILLING_RETURN = 2
+
+# Order time
+ORDER_TIME_GTC = 0
+ORDER_TIME_DAY = 1
+ORDER_TIME_SPECIFIED = 2
+ORDER_TIME_SPECIFIED_DAY = 3
+
+# Position types
+POSITION_TYPE_BUY = 0
+POSITION_TYPE_SELL = 1
+
+# Deal types
+DEAL_TYPE_BUY = 0
+DEAL_TYPE_SELL = 1
+DEAL_TYPE_BALANCE = 2
+DEAL_TYPE_CREDIT = 3
+DEAL_TYPE_CHARGE = 4
+DEAL_TYPE_CORRECTION = 5
+DEAL_TYPE_BONUS = 6
+DEAL_TYPE_COMMISSION = 7
+DEAL_TYPE_COMMISSION_DAILY = 8
+DEAL_TYPE_COMMISSION_MONTHLY = 9
+DEAL_TYPE_COMMISSION_AGENT_DAILY = 10
+DEAL_TYPE_COMMISSION_AGENT_MONTHLY = 11
+DEAL_TYPE_INTEREST = 12
+DEAL_TYPE_BUY_CANCELED = 13
+DEAL_TYPE_SELL_CANCELED = 14
+DEAL_DIVIDEND = 15
+DEAL_DIVIDEND_FRANKFURT = 16
+DEAL_TAX = 17
+
+# Deal entries
+DEAL_ENTRY_IN = 0
+DEAL_ENTRY_OUT = 1
+DEAL_ENTRY_INOUT = 2
+DEAL_ENTRY_OUT_BY = 3
+
+# Trade modes
+ACCOUNT_TRADE_MODE_DEMO = 0
+ACCOUNT_TRADE_MODE_CONTEST = 1
+ACCOUNT_TRADE_MODE_REAL = 2
+
+# Margin modes
+ACCOUNT_MARGIN_MODE_RETAIL_NETTING = 0
+ACCOUNT_MARGIN_MODE_EXCHANGE = 1
+ACCOUNT_MARGIN_MODE_RETAIL_HEDGING = 2
+
+# Order reasons
+ORDER_REASON_CLIENT = 0
+ORDER_REASON_MOBILE = 1
+ORDER_REASON_WEB = 2
+ORDER_REASON_EXPERT = 3
+ORDER_REASON_SL = 4
+ORDER_REASON_TP = 5
+ORDER_REASON_SO = 6
+
+# Reason for positions/deals
+POSITION_REASON_CLIENT = 0
+POSITION_REASON_MOBILE = 1
+POSITION_REASON_WEB = 2
+POSITION_REASON_EXPERT = 3
+
+# Symbol trade modes
+SYMBOL_TRADE_MODE_DISABLED = 0
+SYMBOL_TRADE_MODE_LONG = 1
+SYMBOL_TRADE_MODE_SHORT = 2
+SYMBOL_TRADE_MODE_CLOSE = 4
+
+# Symbol trade execution
+SYMBOL_TRADE_EXECUTION_REQUEST = 0
+SYMBOL_TRADE_EXECUTION_INSTANT = 1
+SYMBOL_TRADE_EXECUTION_MARKET = 2
+SYMBOL_TRADE_EXECUTION_EXCHANGE = 3
+
+# Trade calc modes
+SYMBOL_TRADE_CALC_MODE_FOREX = 0
+SYMBOL_TRADE_CALC_MODE_CFD = 1
+SYMBOL_TRADE_CALC_MODE_FUTURES = 2
+SYMBOL_TRADE_CALC_MODE_CFDINDEX = 3
+SYMBOL_TRADE_CALC_MODE_CFDLEVERAGE = 4
+
+# Error codes
+RES_E_SUCCESS = 10009
+RES_E_FAIL = -1
+RES_E_INVALID_PARAMS = -2
+RES_E_NO_MONEY = -3
+RES_E_NOT_FOUND = -4
+RES_E_MARKET_CLOSED = -5
+RES_E_TRADE_DISABLED = -6
+RES_E_PRICE_LIMIT = -7
+RES_E_TOO_MANY_REQUESTS = -8
+RES_E_SERVER_BUSY = -9
+RES_E_NO_CONNECTION = -10
+
+
+def initialize(
+    path: str | None = None,
+    login: int | str | None = None,
+    password: str | None = None,
+    server: str = "",
+    timeout: int | None = None,
+    portable: bool | None = None,
+    quiet: bool = False,
+    **kwargs,
+) -> bool:
+    global _backend
+    if _backend is not None:
+        _backend.stop()
+    _backend = MT5Backend(terminal_path=path or "", quiet=quiet)
+    ok = _backend.start(path=path)
+    if ok and login is not None and password is not None:
+        ok = _backend.login(str(login), password, server)
+    return ok
+
+
+def shutdown() -> None:
+    global _backend
+    if _backend is not None:
+        _backend.stop()
+        _backend = None
+
+
+def login(login: int | str, password: str, server: str = "", timeout: int = 30000) -> bool:
+    _require_backend()
+    return _backend.login(str(login), password, server)
+
+
+def account_info() -> MqlAccountInfo | None:
+    _require_backend()
+    return _backend.account_info()
+
+
+def symbols_get(symbol: str | None = None) -> tuple[MqlSymbolInfo, ...] | None:
+    _require_backend()
+    return _backend.symbols_get(symbol)
+
+
+def symbol_info(symbol: str) -> MqlSymbolInfo | None:
+    _require_backend()
+    return _backend.symbol_info(symbol)
+
+
+def symbol_info_tick(symbol: str) -> MqlTick | None:
+    _require_backend()
+    return _backend.symbol_info_tick(symbol)
+
+
+def symbol_select(symbol: str, enable: bool = True) -> bool:
+    _require_backend()
+    return _backend.symbol_select(symbol, enable)
+
+
+def copy_rates_from_pos(
+    symbol: str,
+    timeframe: int,
+    start_pos: int,
+    count: int,
+) -> tuple[MqlRates, ...] | None:
+    _require_backend()
+    return _backend.copy_rates_from_pos(symbol, timeframe, start_pos, count)
+
+
+def copy_rates_from(
+    symbol: str,
+    timeframe: int,
+    date_from: int,
+    count: int,
+) -> tuple[MqlRates, ...] | None:
+    _require_backend()
+    return _backend.copy_rates_from(symbol, timeframe, date_from, count)
+
+
+def copy_rates_range(
+    symbol: str,
+    timeframe: int,
+    date_from: int,
+    date_to: int,
+) -> tuple[MqlRates, ...] | None:
+    _require_backend()
+    return _backend.copy_rates_range(symbol, timeframe, date_from, date_to)
+
+
+def order_send(request: dict) -> MqlTradeResult:
+    _require_backend()
+    return _backend.order_send(request)
+
+
+def positions_get(symbol: str = "") -> tuple[MqlPosition, ...] | None:
+    _require_backend()
+    return _backend.positions_get(symbol)
+
+
+def orders_get(symbol: str = "") -> tuple[MqlOrder, ...] | None:
+    _require_backend()
+    return _backend.orders_get(symbol)
+
+
+def history_deals_get(date_from: int = 0, date_to: int = 0) -> tuple[MqlDeal, ...] | None:
+    _require_backend()
+    return _backend.history_deals_get(date_from, date_to)
+
+
+def history_orders_get(date_from: int = 0, date_to: int = 0) -> tuple[MqlOrder, ...] | None:
+    _require_backend()
+    return _backend.history_orders_get(date_from, date_to)
+
+
+def last_error() -> int:
+    return 0
+
+
+def _require_backend() -> None:
+    if _backend is None:
+        raise RuntimeError(
+            "MT5 not initialized. Call mt5_mac.initialize() first."
+        )

mt5_mac/agent.py

@@ -0,0 +1,174 @@
+"""
+Agent script for mt5_mac library.
+Runs inside Wine on macOS, using the official MetaTrader5 Python package.
+Communicates via JSON over stdin/stdout.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import sys
+import traceback
+from typing import Any
+
+try:
+    import MetaTrader5 as mt5
+except ImportError:
+    print(json.dumps({"error": "MetaTrader5 not available in this Wine Python environment"}))
+    sys.exit(1)
+
+TERMINAL_PATH = os.environ.get(
+    "MT5_TERMINAL_PATH",
+    r"C:\Program Files\MetaTrader 5\terminal64.exe",
+)
+
+
+def _serialize(obj: Any) -> Any:
+    if obj is None:
+        return None
+    if hasattr(obj, "_asdict"):
+        return _serialize(obj._asdict())
+    if isinstance(obj, dict):
+        return {k: _serialize(v) for k, v in obj.items()}
+    if isinstance(obj, (list, tuple)):
+        return [_serialize(v) for v in obj]
+    if hasattr(obj, "dtype"):
+        return _serialize_array(obj)
+    if hasattr(obj, "tolist"):
+        return _serialize(obj.tolist())
+    if isinstance(obj, bytes):
+        return obj.decode("utf-8", errors="replace")
+    if isinstance(obj, float):
+        if obj != obj:
+            return None
+        return obj
+    if hasattr(obj, "item"):
+        return obj.item()
+    return obj
+
+
+def _serialize_array(arr: Any) -> list[dict]:
+    names = arr.dtype.names
+    result = []
+    for row in arr:
+        item = {}
+        for name in names:
+            val = row[name]
+            if isinstance(val, bytes):
+                val = val.decode("utf-8", errors="replace")
+            elif hasattr(val, "item"):
+                val = val.item()
+            item[name] = val
+        result.append(item)
+    return result
+
+
+def handle(cmd: dict) -> dict:
+    action = cmd.get("action", "")
+
+    if action == "initialize":
+        path = cmd.get("path", TERMINAL_PATH)
+        success = mt5.initialize(path=path)
+        return {"success": success}
+
+    if action == "login":
+        success = mt5.login(int(cmd["login"]), cmd["password"], cmd.get("server", ""))
+        return {"success": success}
+
+    if action == "shutdown":
+        mt5.shutdown()
+        return {"success": True}
+
+    if action == "account_info":
+        info = mt5.account_info()
+        return _serialize(info) if info else {}
+
+    if action == "symbols_get":
+        symbol = cmd.get("symbol")
+        symbols = mt5.symbols_get(symbol) if symbol else mt5.symbols_get()
+        if symbols:
+            return {"symbols": _serialize(symbols)}
+        return {"symbols": []}
+
+    if action == "symbol_info":
+        info = mt5.symbol_info(cmd["symbol"])
+        return _serialize(info) if info else {}
+
+    if action == "symbol_select":
+        return {"success": mt5.symbol_select(cmd["symbol"], cmd.get("enable", True))}
+
+    if action == "tick_info":
+        tick = mt5.symbol_info_tick(cmd["symbol"])
+        if tick is None:
+            mt5.symbol_select(cmd["symbol"], True)
+            tick = mt5.symbol_info_tick(cmd["symbol"])
+        return _serialize(tick) if tick else {}
+
+    if action == "rates_get":
+        rates = mt5.copy_rates_from_pos(
+            cmd["symbol"],
+            cmd.get("timeframe", 1),
+            cmd.get("start_pos", 0),
+            cmd.get("count", 100),
+        )
+        return {"rates": _serialize(rates)}
+
+    if action == "copy_rates_from":
+        rates = mt5.copy_rates_from(
+            cmd["symbol"],
+            cmd["timeframe"],
+            cmd["date_from"],
+            cmd["count"],
+        )
+        return {"rates": _serialize(rates)}
+
+    if action == "copy_rates_range":
+        rates = mt5.copy_rates_range(
+            cmd["symbol"],
+            cmd["timeframe"],
+            cmd["date_from"],
+            cmd["date_to"],
+        )
+        return {"rates": _serialize(rates)}
+
+    if action == "order_send":
+        result = mt5.order_send(cmd["request"])
+        return _serialize(result) if result else {}
+
+    if action == "positions_get":
+        symbol = cmd.get("symbol", "")
+        positions = mt5.positions_get(symbol=symbol) if symbol else mt5.positions_get()
+        return {"positions": _serialize(positions)}
+
+    if action == "orders_get":
+        symbol = cmd.get("symbol", "")
+        orders = mt5.orders_get(symbol=symbol) if symbol else mt5.orders_get()
+        return {"orders": _serialize(orders)}
+
+    if action == "history_deals":
+        deals = mt5.history_deals_get(cmd.get("from", 0), cmd.get("to", 0))
+        return {"deals": _serialize(deals)}
+
+    if action == "history_orders":
+        orders = mt5.history_orders_get(cmd.get("from", 0), cmd.get("to", 0))
+        return {"orders": _serialize(orders)}
+
+    return {"error": f"Unknown action: {action}"}
+
+
+def main():
+    for line in sys.stdin:
+        line = line.strip()
+        if not line:
+            continue
+        try:
+            result = handle(json.loads(line))
+        except Exception as e:
+            result = {"error": str(e), "traceback": traceback.format_exc()}
+        sys.stdout.write(json.dumps(result) + "\n")
+        sys.stdout.flush()
+
+
+if __name__ == "__main__":
+    main()