mt5api Documentation

FastAPI-based REST API for MetaTrader 5 market data, account information, and trading operations.

Overview

mt5api exposes MT5 data and trading operations over HTTP using FastAPI. It relies on the underlying MT5 client library for connectivity and adds optional authentication and response formatting suitable for analytics workflows.

The API server must run on Windows because the MetaTrader5 Python package is Windows-only. Run mt5api on a Windows host with MetaTrader 5 installed and logged in. API clients can connect from any operating system.

Features

  • REST endpoints for symbols, market data, account info, orders, history, calculations, and trading operations
  • JSON and Apache Parquet responses
  • Optional API key authentication
  • Structured JSON logging
  • OpenAPI/Swagger docs built in

Requirements

  • Python 3.11+
  • Windows OS with MetaTrader 5 terminal installed and logged in
  • Linux and macOS are not supported for the API server runtime, but they work for HTTP clients

Installation

Install mt5api on the Windows host that runs MetaTrader 5.

pip install mt5api

Quick Start

$env:MT5API_SECRET_KEY = "your-secret-api-key"  # Optional: omit to disable auth
$env:MT5API_ROUTER_PREFIX = "/api/v1"     # Optional: omit for root-level routes
uv run uvicorn mt5api.main:app --host 0.0.0.0 --port 8000

Once the API is running, use these curl examples from any client machine.

Set MT5API_MAX_MARKET_BOOK_SUBSCRIPTIONS to cap active market-book subscriptions. The default limit is 100.

Replace windows-host with the DNS name or IP address of the Windows machine running mt5api. If you run the request on that Windows host, localhost also works. In PowerShell, use curl.exe if curl resolves to Invoke-WebRequest.

curl "http://windows-host:8000/health"

# Include X-API-Key only when MT5API_SECRET_KEY is configured on the server.
curl -H "X-API-Key: your-secret-api-key" "http://windows-host:8000/symbols?group=*USD*"

API Reference

  • REST API - Endpoint overview, auth, formats, and examples
  • Deployment - Windows service setup

License

MIT License - see LICENSE.