Embed CME Tracker on your site
A small live widget with the current space weather: solar wind, Kp index, and inbound CME arrivals. Plus an open JSON API if you'd rather render the numbers yourself. Free, no key, no scripts on your page.
1The widget
Pick a look, then copy the snippet. The widget refreshes itself every 2 minutes and always shows how fresh its data is. If our upstream feeds ever hiccup it shows the last good numbers with their timestamp, never an error on your page.
Parameters · numbers widget (/embed)
| Param | Values | Meaning |
|---|---|---|
theme | light (default) · dark | Match your site's background. |
size | full (default) · compact | Full shows Kp, wind, Bz and the next CME arrival; compact is a single row (Kp · wind · Bz). Suggested iframe sizes: 320×180 full, 320×92 compact. The layout is fluid, so nearby sizes work too. |
Parameters · aurora widget (/embed-aurora)
A one-glance northern-lights outlook: status headline, current Kp, how far south the oval reaches at the viewer's longitude (derived from their timezone), the 3-night forecast max, and moonlight. Param: theme=light|dark. Suggested size 320×150. Data: GET /api/aurora (open CORS) if you'd rather render it yourself.
Parameters · live map widget (/embed-map)
The map is the real tracker renderer in miniature: every CME NASA has catalogued in the last 90 days, expanding from the Sun past the inner planets in real time, with the same drag-model physics as the full site. It's always dark (it's space). Square iframes work best, 320×320 and up.
| Param | Values | Meaning |
|---|---|---|
zoom | 0.35–3 (default 0.82) | Default fits Mars' orbit; 1 matches the full site's framing. |
hide | classes, e.g. S (default) · S,C · empty for all | Hide CME speed classes; slow S-class is hidden by default to keep the small view clean. |
labels / flares | 1 (default) · 0 | Planet/Sun labels and the solar-flare bursts at the Sun. |
sparkles | 0 (default) · 1 | The particle haze inside CME wedges. Off by default in the widget to keep it light on your page. |
interactive | 0 (default) · 1 | By default the map is a click-through link to the tracker (so it never captures your page's scroll); 1 enables drag-pan and scroll-zoom inside the frame. |
2The JSON API
GET https://www.cmetracker.ai/api/current. Open CORS, no key. Cached at the edge for 2 minutes (the data itself refreshes from NASA/NOAA every 15). The shape below is a stable contract: fields may be added, but existing ones won't change without a schemaVersion bump.
{
"schemaVersion": 1,
"dataUpdatedAt": "2026-07-03T21:15:04Z", // last successful upstream refresh
"stale": false, // true when that's >35 min ago
"wind": { "speed": 421.3, "density": 4.2, "bz": -1.8 }, // km/s · p/cm³ · nT (null if unavailable)
"kp": { "value": 2.7, "gScale": null }, // gScale "G1".."G5", null below storm level
"latestCme": {
"time": "2026-07-03T04:24:00Z", // most recent CME NASA has catalogued
"speed": 512.0, // km/s
"earthDirected": false,
"arrivalTime": null // ISO time if Earth-directed
},
"nextArrival": { // soonest inbound Earth-directed CME, or null
"cmeTime": "2026-07-02T11:00:00Z",
"arrivalTime": "2026-07-05T03:00:00Z", // best estimate (ensemble median when one has run)
"window": { // 80% arrival window, or the estimate ± 12 h
"from": "2026-07-04T17:00:00Z",
"to": "2026-07-05T14:00:00Z",
"calibrated": true
},
"speed": 890.0,
"estKp": 6.2, // model estimate, see /science
"gScale": "G2"
},
"attribution": "Data: NASA DONKI & NOAA SWPC · cmetracker.ai"
}
- Availability: an upstream (NASA/NOAA) outage never produces an error: you get the last good numbers with their real
dataUpdatedAtandstale: true. A non-200 response means there has never been data. - Fair use: it's edge-cached, so poll politely (every 1–5 min is plenty). Please keep the attribution when you display the numbers.
- What the numbers mean: see the guide; how they're computed: the science.
3Use it in Claude or ChatGPT
The same live data is available to AI assistants. Connect CME Tracker to Claude, ChatGPT or another assistant, then ask in plain words: is a solar storm heading for Earth, when will it arrive, can I see the aurora tonight from my town. It is free and read-only, with no key and no account.
The address to paste is https://www.cmetracker.ai/mcp. How to connect it, and what it can answer.
4Notes
- The widget is a static page with one same-origin fetch: no cookies and no third-party scripts run on your site. We record one anonymous load event, at most once a day per browser and tagged with your site's address, as the privacy page describes.
- Estimated storm levels are model output for education, not operational forecasts. For those, see NOAA SWPC.