Alice — an open-source AI trading bot covering equities, crypto, commodities, forex, and macro
| 1 | """Headway broker presets for MetaTrader 5.""" |
| 2 | |
| 3 | from __future__ import annotations |
| 4 | |
| 5 | # Official Headway MT5 servers (from Headway support docs). |
| 6 | # Demo: Headway-Demo (mt5.demo.trade-hw.online) |
| 7 | # Real: Headway-Real (mt5.real.trade-hw.online) |
| 8 | HEADWAY_DEMO_SERVERS: tuple[str, ...] = ( |
| 9 | "Headway-Demo", |
| 10 | "mt5.demo.trade-hw.online", |
| 11 | ) |
| 12 | |
| 13 | HEADWAY_REAL_SERVERS: tuple[str, ...] = ( |
| 14 | "Headway-Real", |
| 15 | "mt5.real.trade-hw.online", |
| 16 | ) |
| 17 | |
| 18 | DEFAULT_DEMO_SERVER = "Headway-Demo" |
| 19 | DEFAULT_REAL_SERVER = "Headway-Real" |
| 20 | |
| 21 | |
| 22 | def list_headway_servers() -> dict[str, tuple[str, ...]]: |
| 23 | """Return known Headway servers grouped by account type.""" |
| 24 | return {"demo": HEADWAY_DEMO_SERVERS, "real": HEADWAY_REAL_SERVERS} |
| 25 | |
| 26 | |
| 27 | def resolve_headway_server(server: str | None, demo: bool = False) -> str: |
| 28 | """Resolve a user-supplied server value to a concrete Headway server name. |
| 29 | |
| 30 | Args: |
| 31 | server: Raw server string, or None to use the default. |
| 32 | demo: If True and server is None, return the demo server. |
| 33 | |
| 34 | Returns: |
| 35 | Concrete server name to pass to MT5 login. |
| 36 | """ |
| 37 | if server is None or not server.strip(): |
| 38 | return DEFAULT_DEMO_SERVER if demo else DEFAULT_REAL_SERVER |
| 39 | |
| 40 | cleaned = server.strip() |
| 41 | lowered = cleaned.lower() |
| 42 | |
| 43 | # Accept shortcuts like "demo", "real", "headway-demo", "headway-real". |
| 44 | if lowered in {"demo", "headway-demo", "headway demo"}: |
| 45 | return DEFAULT_DEMO_SERVER |
| 46 | if lowered in {"real", "headway-real", "headway real"}: |
| 47 | return DEFAULT_REAL_SERVER |
| 48 | |
| 49 | return cleaned |