MT5-LinuxOHLCV 0.1.0

Linux client helpers for MetaTrader 5 via mt5linux

mt5linux-client

mt5linux-client is a small Linux-side wrapper around mt5linux that fetches OHLCV data from a running MetaTrader 5 terminal exposed through the bridge.

Install

pip install mt5linux-client

For local development from this workspace:

pip install .

Requirements

• A running MetaTrader 5 terminal started under Wine or another Windows-compatible environment.
• The mt5linux bridge running and reachable from Linux on the address and port you pass into the client.
• Symbols available in the terminal before requesting data.

Start MetaTrader 5

Launch the MetaTrader 5 terminal through Wine:

WINEPREFIX=~/.mt5 wine "$HOME/.mt5/drive_c/Program Files/MetaTrader 5/terminal64.exe" &

Keep the terminal running in the background before starting the Python client.

Install Windows-side Python packages

The Wine Python environment must have both mt5linux and MetaTrader5 installed before the bridge can start:

WINE_PYTHON="$HOME/.mt5/drive_c/users/$USER/AppData/Local/Programs/Python/Python311/python.exe"
WINEPREFIX=~/.mt5 wine "$WINE_PYTHON" -m pip install mt5linux MetaTrader5

Start the mt5linux bridge

From the Wine-installed Windows Python, start the mt5linux server that listens for Linux-side clients:

WINE_PYTHON="$HOME/.mt5/drive_c/users/$USER/AppData/Local/Programs/Python/Python311/python.exe"
WINEPREFIX=~/.mt5 wine "$WINE_PYTHON" -m mt5linux

Usage

MT5Client holds the connection settings and keeps the bridge connection open, so you only pay the connection warm-up once, no matter how many times you call fetch_ohlcv. Use it as a context manager so the connection is always closed:

from mt5_linux_client import MT5Client

with MT5Client(
    terminal_path=r"C:\Program Files\MetaTrader 5\terminal64.exe",
    bridge_host="127.0.0.1",
    bridge_port=18812,
) as client:
    df = client.fetch_ohlcv(["PETR4"], timeframes=["1m", "1d"])
    print(df.tail())

    # Reuses the same open connection.
    df2 = client.fetch_ohlcv(["VALE3"], timeframes="1d")

You can also manage the connection lifecycle manually:

client = MT5Client(bridge_host="127.0.0.1", bridge_port=18812)
client.connect()
try:
    df = client.fetch_ohlcv(["PETR4"], timeframes="1d")
finally:
    client.close()

The default bridge settings remain localhost:18812, so you only need to pass these when the server is elsewhere.

Testing

Tests stub out the mt5linux bridge, so they run without a MetaTrader terminal or the mt5linux server:

pip install -e ".[test]"
pytest

License

GNU General Public License v3.0. See LICENSE for the full text.