Market Snapshot
Live Market Snapshot Widget
A plain-language homepage panel: the current price for a symbol plus a short, non-predictive line of context. Built for editorial and marketing pages that want a live number without a chart.
The real embed in preview mode — synthetic data, no API key, zero network calls. Live data starts once you add your key.
- From
- $9.99 /mo
- Included
- 1 domain slot
- Shows
- Live quote + plain-language context · one symbol.
Base covers one domain; each extra slot adds half the base. Manage domains and your key from your dashboard.
What it shows
A plain-language homepage panel: the current price for a symbol plus a short, non-predictive line of context. Built for editorial and marketing pages that want a live number without a chart.
Who it's for
- Editorial article giving readers a live number without a full chart.
- Marketing homepage panel next to a product-value section.
- Docs page showing a minimal quote embed example.
- News-site sidebar module for one tracked instrument.
The data contract
This widget reads only public market data through our hosted gateway — no account data, no order book, no personal data.
The gallery and this preview run in SIMULATED mode — synthetic shapes, no key, no network. Live data flows only after checkout, on your authorized domains.
Embed it
- Subscribe from your dashboard and add the domains you'll embed on.
- Copy your public
wk_key from the widget panel. - Drop the snippet below into your page, swapping in your key and symbol.
<script src="https://tickatlas.com/widgets/embed.js?w=market-snapshot&k=wk_YOUR_KEY&symbol=BTCUSD"></script>Default is light — the snippet stays clean. Pick Dark or Auto (Auto follows each visitor’s system theme) to append &theme= and preview it live.
Embed parameters
The querystring on the embed.js script tag above.
| Parameter | Type | Required | Description |
|---|---|---|---|
| w | string | Yes | Widget slug — fixed to “market-snapshot” 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. |
| symbol | symbol | No | The symbol to display, uppercased. Must be within the widget’s allowed set. Allowed: BTCUSD, XAUUSD, EURUSD, GBPUSD. Default: BTCUSD. |
| 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. |
The wk_ key is public by design —
it only works on the domains you authorize, and you can revoke it any time from your dashboard.
Data endpoint
The embed calls this hosted endpoint for you on each refresh, using a short-lived token
minted from your wk_ key —
it never carries your key to the browser. These are its parameters and the values this widget uses.
Endpoint parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | symbol | No | One symbol; must be within the widget’s allowed set (server-enforced). Allowed: BTCUSD, XAUUSD, EURUSD, GBPUSD. Default: BTCUSD. |
Set symbol on the embed
to any one of this widget’s allowed symbols (BTCUSD, XAUUSD, EURUSD, GBPUSD); it defaults to
BTCUSD if omitted. A symbol outside this set is
rejected by the gateway before any data is fetched, and the widget shows its
“unavailable” state.
Response
Every response is a JSON envelope { success, widget, cached, data }.
The data object for this widget:
Good to know
- Theming & isolation
-
The widget renders inside a sandboxed Shadow DOM with
all:initial, so your page's CSS and scripts can't reach in and its styles can't leak out. It fits the width of its container — never wider — and brings its own light palette. - Refresh, caching & limits
-
It refreshes about every 15 seconds against cached data, so many visitors collapse to one
computation on our side. Requests are rate-limited per key and per domain; over the limit the
gateway returns
429and the widget simply keeps its last frame until the next tick. - When data is unavailable
- If a symbol has no current data, the widget shows an explicit “unavailable” / “no data” state — never a fabricated or zeroed value. A revoked key or an unauthorized domain leaves the widget in that same state; it never throws on your page.
- Pricing & domain slots
- Billed monthly per domain slot. The base ($9.99/mo) covers one domain; each extra slot adds half the base. Slots are fixed at purchase — cancel any time and the embed stays live to the end of the paid month, then stops.
Frequently asked
Which symbol does it track?
One symbol per embed from BTCUSD, XAUUSD, EURUSD, or GBPUSD, set with symbol=.
What does the context line say?
A short plain-language line built from the same verified quote. It's descriptive, not a prediction of where price goes next.
How often does it refresh?
~15-second cached poll. The last-known-good quote is held on any feed interruption, never a placeholder value.
Is it free to try?
The preview is free to test with synthetic data and no key; a live embed needs a paid subscription.
Related widgets
Live Price Ticker Widget
Live bid / ask · one symbol · 15-second refresh.
Live Forex Rates Widget
Live mid-market quote · one pair · reference rate only.
Currency Amount Converter Widget
One pair’s quote × amount (local calculation) · fees excluded.
RSI Widget
Bid + labelled H1 RSI (RSI_14) · one symbol.
Related resources
Prefer to pull this data through the API instead of an embed? These endpoints and guides cover the same market data.
Embed it in minutes
Preview it with synthetic data and no key, then add your key to go live on your domains — from $9.99/mo per domain.