Gridomics API
A free, open, keyless API for Europe's live grid: carbon intensity, day-ahead price, renewable share, cross-border flows and forecasts — with every number traceable to its primary source.
Base URL
https://api.gridomics.com- Free and keyless — no sign-up to read.
- CORS-enabled (Access-Control-Allow-Origin: *) — call it straight from the browser.
- Anonymous rate limit: 60/min, 1,000/hour, 10,000/day per IP. State is returned in X-RateLimit-* headers; a 429 names the window and Retry-After.
- An optional API key lifts this to 600/min, 10,000/hour, 100,000/day.
The honesty model
The API never invents a number. Two fields on every zone tell you exactly how much to trust it:
- freshness — fresh / delayed / modeled / unknown. 'fresh' means the freshest slot the source has published (typically ~1h behind real time, not real-time); 'delayed' is real data up to 6h old; an 'unknown' zone has all data fields nulled — no trustworthy reading right now.
- coverage — the share of generation backed by a committed IPCC emission factor (0–1).
- no guesses — carbon intensity and trade balance have no honest day-ahead source, so the forecast omits them rather than guessing — they read as no-data ahead of now.
Quickstart
Every zone, current snapshot
curl https://api.gridomics.com/api/v1/zonesOne zone (Czechia)
curl https://api.gridomics.com/api/v1/zones/CZDay-ahead forecast (all zones)
curl https://api.gridomics.com/api/v1/forecastEndpoints
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/zones | Current snapshot for every zone (a malformed zone is dropped, not fatal). |
| GET | /api/v1/zones/{zoneId} | Current snapshot for one zone. |
| GET | /api/v1/zones/{zoneId}/history | Trailing time series for one zone (window=24h or 7d). |
| GET | /api/v1/zones/{zoneId}/daily | Permanent daily aggregates for one zone (from/to dates) — long-horizon archive. |
| GET | /api/v1/zones/{zoneId}/forecast-accuracy | How accurate this zone's day-ahead wind+solar forecast has been (MAE + bias). |
| GET | /api/v1/zones/{zoneId}/reprocess | Re-derive one zone-day from the immutable raw archive and compare — reproducibility. |
| GET | /api/v1/history/at | All-zones snapshot as of a past instant (powers the time scrubber). |
| GET | /api/v1/forecast | Day-ahead forecast for all zones (price + wind+solar share of demand). |
| GET | /api/v1/status | Data-health summary: per-source + per-zone freshness. |
An operator-only admin endpoint exists for archive backfill; it is bearer-gated and documented in the spec for transparency, not a public surface.
Full reference
The machine-readable OpenAPI 3.1 spec is the contract; an interactive reference lets you explore and try each endpoint.
Embed a zone
Drop a live single-zone badge onto any page with an iframe. Swap CZ for any zone id; add ?theme=light for the light card.
<iframe src="https://gridomics.com/embed/CZ" width="256" height="116" style="border:0" loading="lazy" title="Gridomics — CZ"></iframe>Please credit "data via Gridomics" when you use it.