TickAtlas
Available now Price & rates ForexGoldCrypto
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.

Get the widget See the embed code
One script tag Light, dark & auto themes Domain-authorized public key Synthetic preview with no key
market-snapshot · preview mode
no network
SIMULATED

The real embed in preview mode — synthetic data, no API key, zero network calls. Live data starts once you add your key.

$9.99/ month · 1 domain slot

Each additional domain slot adds half the base price.

Get it
quoteGateway kind
One symbolSymbols per embed
~15 secCached refresh
4Covered instruments
What it shows

A fast answer to one useful question.

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.

  • Live quote + plain-language context · one symbol.
  • Pick the instrument with symbol=; it defaults to BTCUSD when you omit it.
  • Renders inside a sandboxed Shadow DOM, so it cannot collide with your page’s CSS or scripts.
What the gateway serves itSIMULATED PREVIEW
Gateway kind
quote
Symbol axis
One symbol, set from the embed
Allowed
BTCUSD, XAUUSD, EURUSD, GBPUSD
Default
BTCUSD
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.

quote · one symbol
Where it fits

Small enough for a sidebar. Useful enough for a homepage.

Market Snapshot 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.

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.

Embed it

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 Market Snapshot 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 and symbol, then drop the generated script tag into the page.

Widget theme 
<script
  src="https://tickatlas.com/widgets/embed.js?w=market-snapshot&k=wk_YOUR_KEY&symbol=BTCUSD"></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.

Embed parameters

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, a symbol and a theme.

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.

Default symbol

Omit symbol= and the gateway serves BTCUSD.

BTCUSD

Allowed instruments

Set symbol= to any one of these 4.

BTCUSDXAUUSDEURUSDGBPUSD
Under the hood

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.

YOUR PAGE embed.js wk_ key + domain TICKATLAS Widget gateway domain check · token mint HOSTED ENDPOINT market-snapshot cached quote data RENDER Shadow DOM isolated styles ~15 second refresh · cached reads · per-key / per-domain rate limits · last verified frame held through temporary gaps
CSS isolation

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.

Domain authorization

The public wk_ key only renders on domains you add to the subscription, and you can revoke it from your dashboard at any time.

Cached refresh

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.

Graceful failure

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.

Market Snapshot subscription

$9.99/ month

Base subscription includes 1 domain slot.

  • Live widget data on the domains you authorize
  • Light, dark and auto themes
  • Any one of its allowed instruments
  • A public, revocable widget key
  • Cancel any time; the embed stays live through the paid month
Subscribe

Domain slot calculator

Each additional domain adds half the base price.

$9.99 per month

1 domain slot = $9.99 base subscription. Slots are fixed at purchase; manage domains and your key from your dashboard.

Data contract

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.

GET widget endpointhosted

Market data for this widget

Live quote + plain-language context · one symbol.

/widgets/api/market-snapshot/quote?symbol=BTCUSD
Response shape{ success, widget, cached, data }
{
  "success": true,
  "widget": "market-snapshot",
  "cached": true,
  "data": { symbol, bid, ask, spread }
}

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.

Frequently asked

Before you embed it.

What the widget reads, how preview mode works, and what happens when data is temporarily unavailable.

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.

Market Snapshot

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 $9.99/mo per domain.

Get Market Snapshot Browse all widgets