Lunar-Trader

LunarTrader is a lightweight Python wrapper around MetaTrader5-style APIs with SQLite-backed caching so trading workflows can continue in offline or degraded-network conditions.

Features

• MetaTrader5-compatible wrapper with account, terminal, symbol, rate, tick, order, position, and deal methods
• SQLite-backed caching for MT5 data when the live MT5 connection is unavailable
• OS-aware default cache locations for Linux, macOS, and Windows
• Platform-aware installation behavior that selects MetaTrader5 on Windows and mt5linux on Linux
• Test suite that exercises the cache layer and offline fallback path without requiring a live terminal connection

Installation

Install from the repository root:

python -m pip install -e .

For development and test dependencies:

python -m pip install -e .[dev]

Basic usage

from LunarTrader import MetaTrader5

mt5 = MetaTrader5()
print(mt5.mt5_online())
print(mt5.db_online())
print(mt5.version())

You can also provide an explicit cache directory if you want the database stored somewhere other than the default OS-specific location:

from LunarTrader import MetaTrader5

mt5 = MetaTrader5(db_name="mt5", db_dir="/tmp/lunartrader")

Running tests

Run the unit tests with:

python -m pytest -q tests

Notes

The wrapper will use the last cached value whenever a live MT5 connection is unavailable, timed out, or explicitly disabled through the offline mode.