HonorPro Hub · Feature Guide

Price Alerts

A quote-stream watchdog that tells your dealing desk in Telegram — within seconds — when prices stop flowing during market hours, and again when they recover.

Why it exists

A dead price feed is the most expensive kind of silence: traders see frozen charts, stops don't trigger, and nobody notices until the complaints arrive. Price Alerts turns that silence into a message. It runs where your feed runs — on your own gateway — and understands trading sessions, so a quiet Saturday never pages anyone, while a stall in the middle of the London session pages everyone in the ops chat.

What a stall looks like in Telegram

⚠️ Quote stream stalled: EURUSD.z +34 more
No ticks past threshold on 35 symbol(s): EURUSD.z, GBPUSD.z, USDJPY.z, XAUUSD.z, …

✅ Recovered: Quote stream recovered
Gap 4m 12s on 35 symbol(s).

One incident, one message. A liquidity provider going down kills dozens of symbols in the same second — the watchdog aggregates them into a single alert instead of flooding the chat, stays silent while the incident is ongoing, and closes the loop with a recovery notice carrying the measured gap.

How it works

sequenceDiagram
  participant M as MT5 server
  participant G as Gateway watchdog
  participant A as Hub Agent
  participant H as Hub
  participant T as Telegram
  M->>G: quotes (polled every 5s)
  G->>G: stall detected — market open,
threshold exceeded
  G->>A: event via local outbox
  A->>H: alert.event (outbound WSS)
  H->>T: ⚠️ message to every bound chat
  M->>G: ticks resume
  G->>A: recovery event (gap measured)
  A->>H: alert.resolve
  H->>T: ✅ recovery notice

Detection runs at the feed. The gateway watchdog tracks the last real price change per symbol (bid, ask or server time). A symbol is stalled when the silence exceeds its threshold.
Thresholds are per symbol group. Glob patterns, first match wins — majors can alarm at 30 s while exotics get 5 minutes.
Market hours are respected. Built-in FX weekend window (default Fri 21:00 → Sun 21:05 UTC, configurable) plus per-date overrides for holidays. A closed market is silent by design, and staleness resets at reopen — Sunday's open never alarms on Friday's timestamps.
Delivery is decoupled from detection. Events queue in a bounded local outbox; the Hub Agent forwards them over its outbound-only connection. A hiccup between gateway and Hub delays a message, never loses the incident.
The watchdog is itself watched. If the whole gateway or agent goes down, the Hub's fleet monitoring shows the agent offline — a separate signal from a mere feed stall.

Setting it up

1. Bind your ops chat (in the broker console)

Console → Alerts → Bind a chat. You get a one-time code, valid 15 minutes. From your Telegram ops chat, send it to the Hub bot:

/start a1b2c3d4

Done — the chat appears in your channel list. Bind as many chats as you like; remove them any time.

2. Configure symbols and thresholds

{
  "enabled": true,
  "symbols": ["EURUSD.z", "GBPUSD.z", "USDJPY.z", "XAUUSD.z"],
  "groups": [
    { "match": "XAU*", "threshold_s": 60 },
    { "match": "*.z",  "threshold_s": 30 }
  ],
  "default_threshold_s": 60,
  "poll_sec": 5,
  "weekend":  { "close": "Fri 21:00", "open": "Sun 21:05" },
  "overrides": [ { "date": "2026-12-25", "closed": true } ]
}

Key	Meaning
`symbols`	Instruments to watch. Watch your flagship set — one dead LP shows up on any of them.
`groups`	Glob-matched thresholds in seconds; first match wins.
`weekend`	The weekly closed window, UTC. Outside it, silence is an incident.
`overrides`	Per-date exceptions — holidays, planned maintenance.

3. That's all

The watchdog starts with the gateway when the config says enabled: true; the agent and the Hub do the rest. Nothing about your trading flow changes — detection is a read-only observer on the same quote stream your terminal already serves.

Behaviour details

Gap is honest: measured from the last real tick, not from when the alarm fired.
No repeat spam: one alert per incident, one recovery. (Configurable repeat/escalation is on the roadmap.)
History: every incident — open or resolved — is listed in the console under Alerts, with timestamps and affected symbols.
Isolation: alerts are per broker; your incidents go only to chats you bound.

Privacy note. Only alert metadata leaves your infrastructure: symbol names, timestamps, gap duration. No account data, no orders, no client information — the same data boundary as everything else in the Hub.

HonorPro Hub · Price Alerts v1.0 · 2026-08-20