Alice — an open-source AI trading bot covering equities, crypto, commodities, forex, and macro

Raw
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