Skip to main content

HX113 - News, Alerts, and AI Context

HyperionX has one economic calendar pipeline shared by the News window, the NewsEcon indicator, and Rion's news context. The goal is to avoid three separate implementations with different timing, rate limits, and event filters.

Goals​

After this lesson you should be able to:

  • Open and filter the economic news window.
  • Understand how the shared calendar cache protects the app from request limits.
  • Use the NewsEcon indicator for chart HUD and alert workflows.
  • Know how Rion receives news context.
  • Treat news as context, not as a complete trading signal by itself.

Shared Calendar Service​

The calendar service loads the weekly economic calendar feed and normalizes it into HyperionX event objects. Each event includes:

  • Id.
  • Title.
  • Currency or country code.
  • Impact text.
  • Numeric impact value.
  • Forecast.
  • Previous.
  • Local event time.
  • Stable key.

Operational behavior:

  • Events are converted to local time.
  • Tentative events and events with no usable time are skipped.
  • A shared in-memory cache is used inside the running app.
  • A disk cache is stored under the user's HyperionX local app-data folder.
  • Requests are spaced so multiple windows or indicators do not hammer the provider.
  • A rate-limit response backs off future downloads for several hours.
  • If a fresh request fails, stale cached data can still be used.

This is why the News window and NewsEcon indicator should stay on the shared service instead of each downloading independently.

News Window​

The News window is the user-facing economic calendar. When opened from a chart, the title includes the chart instrument when available.

The window includes:

  • Refresh button.
  • Loading progress.
  • Status text with loaded and filtered event counts.
  • Time filters: next 24 hours, today, this week, all loaded.
  • Search filter.
  • Currency filter with all/none actions.
  • Impact filters for high, medium, low, and other.
  • Saved filter settings.

Saved window filters live in the user's local HyperionX settings folder. This lets traders keep a preferred news view without changing indicator defaults.

NewsEcon Indicator​

NewsEcon is the chart and bot-facing version of the same calendar data. It draws a HUD on the chart and can alert before selected events.

Important properties:

  • News Period: today, next 24 hours, or all week.
  • Max Items: maximum HUD rows.
  • US Only: show only USD events when enabled.
  • Display Impact: high only, high/medium, or all.
  • Refresh Interval Hours: shared service refresh cadence.
  • Alert Impact: no alert, high only, high/medium, or all.
  • Notify Minutes Before: lead time for an alert.
  • Display Minutes After: how long an active event remains visible.
  • Alert Sound File: optional local sound file.
  • Show Background, opacity, font size, line spacing, and colors.
  • X Offset and Y Offset; default X offset is 300.

The indicator uses HyperionX drawing APIs for the HUD. It should not create WPF controls or block the chart thread from OnBarUpdate().

Alert Workflow​

NewsEcon keeps a set of event keys that already triggered alerts. This prevents repeated sound alerts for the same event while the chart continues updating.

Use alerts for operational awareness:

  • A high-impact event is approaching.
  • Liquidity may change.
  • Stops and targets may need review.
  • New strategy entries may need to be paused by user policy.

Do not use the alert itself as proof that a trade should be opened. News timing is context. The trade still needs a tested strategy, risk model, and current market structure.

Rion News Context​

Rion can request economic news context from the same shared calendar service. News context is added when a user asks about:

  • News.
  • Economic calendar.
  • Calendar events.
  • High-impact events.
  • Red-folder style events.

The local API can also return structured news data with filters such as scope, minimum impact, countries, search text, limit, and refresh interval.

Rion should use this context to answer questions like:

  • "What high-impact news is coming up?"
  • "Any USD news before I run this strategy?"
  • "Give me the next 24 hours of economic calendar context."

Rion should not claim that news was loaded from broker market data unless it came from the HyperionX calendar service response.

Handling Rate Limits​

If the provider returns too many requests:

  • HyperionX backs off future fresh requests.
  • Cached calendar data may continue to display.
  • The UI should explain the stale or failed state instead of appearing frozen.
  • Users should avoid repeatedly refreshing multiple news surfaces.

For script authors, the rule is simple: use the shared calendar service or existing NewsEcon indicator. Do not add a second downloader inside another indicator.

Bot And Agent Checklist​

Before a strategy, bot, or agent uses news context:

  • Confirm whether the calendar is fresh or cached.
  • Filter by the currencies that matter to the instrument.
  • Filter by impact level.
  • Convert times to local time before presenting them to the user.
  • Decide whether the news is only informational or part of an explicit trade rule.
  • Log when a decision was influenced by upcoming news.
  • Never place an order only because an event exists.

Acceptance Checklist​

The news workflow is ready when:

  • The News window loads and filters events without theme issues.
  • Currency and impact filters can be saved and restored.
  • NewsEcon displays the expected HUD rows on a chart.
  • Alerts fire once per event at the configured lead time.
  • Rion news responses match the same event source as the window and indicator.
  • Rate limits or download failures produce a readable status instead of a frozen-looking UI.