Economic Calendar Widget
An upcoming timeline of high-impact economic events with time, currency, forecast, and previous values. A schedule-awareness view; it does not predict that an event will move a market.
The real embed in preview mode — synthetic data, no API key, zero network calls. Live data starts once you add your key.
Each additional domain slot adds half the base price.
A fast answer to one useful question.
An upcoming timeline of high-impact economic events with time, currency, forecast, and previous values. A schedule-awareness view; it does not predict that an event will move a market.
- Upcoming high-impact events · time / currency / forecast / previous.
- Takes no symbol parameter — every embed renders the same scope.
- Renders inside a sandboxed Shadow DOM, so it cannot collide with your page’s CSS or scripts.
- Gateway kind
- calendar
- Symbol axis
- No symbol axis
- Pinned impact
- high
- Pinned next_hours
- 48
- Refresh
- ~15 s, cached
Every value here is what the gateway enforces, not a description of it. A parameter outside this scope is rejected before any data is fetched.
Small enough for a sidebar. Useful enough for a homepage.
Economic Event Horizon is a compact derived-data module rather than a full dashboard. It works best where you want one concise market observation with a clearly stated data basis.
Trading-education page pairing news awareness
with market context.
Docs page
demonstrating the calendar kind.
Market-dashboard sidebar
One script tag. No chart library. No build step.
Subscribe, authorize the domains that will host the widget, copy your public
wk_ key, and paste the snippet where you want Economic Event Horizon to render.
Subscribe & authorize domains
Your subscription includes 1 domain slot. Add more slots when the same widget needs to run on more sites.
Copy the public widget key
The wk_ key is meant to appear in the page source. It is restricted to the domains you authorize and can be revoked.
Paste the embed
Choose your theme, then drop the generated script tag into the page.
<script src="https://tickatlas.com/widgets/embed.js?w=economic-event-horizon&k=wk_YOUR_KEY"></script>
Light is the default, so the snippet stays clean. Dark appends &theme=dark;
Auto appends &theme=auto and follows each visitor’s system preference.
Picking one re-renders the preview above in that theme.
Small configuration surface. Predictable output.
The querystring on the embed.js script tag stays intentionally compact.
Most sites only need the widget slug, the public widget key and a theme.
| Parameter | Type | Required | Description |
|---|---|---|---|
| w | string | Yes | Widget slug — fixed to “economic-event-horizon” for this widget. |
| k | string | No | Your public wk_ key. With it the widget goes live on your authorized domains; omit it for the SIMULATED preview (synthetic data, zero network). Default: preview mode. |
| mode | enum | No | Force preview even with a key, e.g. for a staging page. Allowed: live, preview. Default: live when k is present, else preview. |
| theme | enum | No | Colour theme. light (default) is today’s look; dark uses a WCAG-AA dark palette; auto follows each visitor’s system (prefers-color-scheme). Omit for light. Allowed: light, dark, auto. Default: light. |
No symbol axis
This widget has no symbol parameter — every embed renders the same scope.
Themes
Light is the default; dark and auto are query-string switches.
Public embed key outside. Short-lived access inside.
The browser-facing key is domain-scoped by design. The embed exchanges it through our gateway, calls the hosted widget endpoint with short-lived authorization, and renders inside an isolated Shadow DOM.
A sandboxed Shadow DOM with all:initial keeps your page’s styles and scripts out and the widget’s styles in. It fits its container’s width, never wider.
The public wk_ key only renders on domains you add to the subscription, and you can revoke it from your dashboard at any time.
It refreshes about every 15 seconds against cached data, so many visitors collapse onto one computation. Over the per-key / per-domain limit the gateway returns 429 and the widget keeps its last frame.
No current data, a revoked key or an unauthorized domain all produce an explicit “unavailable” state — never a fabricated or zeroed value, and never a thrown error on your page.
Economic Event Horizon subscription
Base subscription includes 1 domain slot.
- Live widget data on the domains you authorize
- Light, dark and auto themes
- The same configured scope on every embed
- A public, revocable widget key
- Cancel any time; the embed stays live through the paid month
Domain slot calculator
Each additional domain adds half the base price.
1 domain slot = $14.99 base subscription. Slots are fixed at purchase; manage domains and your key from your dashboard.
The embed has a simple hosted endpoint behind it.
The embed calls this endpoint for you on each refresh, using a short-lived token
minted from your wk_ key — your key never leaves the gateway.
Market data for this widget
Upcoming high-impact events · time / currency / forecast / previous.
/widgets/api/economic-event-horizon/calendar?impact=high&next_hours=48 { "success": true, "widget": "economic-event-horizon", "cached": true, "data": { events:[{ datetime, currency, event, impact, forecast, previous, actual:null }], count, window_hours, impact } }
Endpoint parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| currencies | string | No | Comma-separated ISO currency codes (e.g. USD,EUR,GBP). Omit for all. Default: all currencies. |
| impact | enum | No | Event impact level. Allowed: high, medium, low. Default: high. This widget pins it to high. |
| next_hours | integer | No | Look-ahead window in hours. `actual` is always null (upcoming events, public shape). Allowed: 1–720. Default: 24. This widget pins it to 48. |
Build a broader market-data surface.
Widgets that pair with Economic Event Horizon on the same page, and the API endpoints behind the same data.
Forex Market Hours Widget
FX session states / overlap / next change (time-based).
View widget →Forex Sessions Clock Widget
FX sessions + high-impact calendar events on a dial.
View widget →Market Session Recap Widget
Session open / high / current from OHLC (+ FX session).
View widget →Before you embed it.
What the widget reads, how preview mode works, and what happens when data is temporarily unavailable.
Which events are shown?
Upcoming high-impact economic events in the next 24 hours, with scheduled time, currency, forecast, and previous values.
Does this predict market impact?
No, it's a schedule-awareness view; it does not claim an event will move any market.
How often does it refresh?
The calendar list refreshes on a ~15-second cached poll as new events roll into the 24-hour window.
Is it free to preview?
Yes, synthetic and keyless; the live widget is a paid subscription.
Embed it in minutes
Preview it with synthetic data and no key. When you're ready, authorize your domain, add the public widget key and switch the same embed to live data — from $14.99/mo per domain.