API

Öffentliche REST-API mit deutscher Stromerzeugung, Verbrauch, EE-Anteil, Day-Ahead-Preisen und eigenen ML-Prognosen für ~48 h voraus. Antworten sind JSON, alle Endpoints sind GET, keine Authentifizierung.

CC-BY-4.0 kostenlos · keine Auth Rate-Limit 120 req/min CORS frei

Maschinenlesbare Übersicht für LLMs: /llms.txt · OpenAPI-Schema: /api/openapi.json · Swagger-UI: /api/docs

Schnellstart

curl "https://strommix.info/api/v1/mix?day=today" | jq '.points[0]'

Liefert Erzeugung pro Energieträger + Verbrauch + EE-Anteil im 15-Minuten-Raster für „heute" (Europe/Berlin).

Zeitreihen

Drei Daten-Achsen — Mix (Erzeugung + Verbrauch), EE-Anteil und Preis. Jede Achse hat einen Punkt-Endpoint (?day=… für einen Kalendertag, 15-min-Slots) und drei Aggregat-Endpoints (/hourly, /daily, /monthly) für gröbere Raster.

Erzeugungs-Mix + Verbrauch

GET /api/v1/mix?day=YYYY-MM-DD

Stack aus 11 Energieträgern (Wind on/offshore, PV, Biomasse, Wasserkraft, sonstige EE, Braun-/Steinkohle, Erdgas, Pumpspeicher, sonstige konv.) plus consumption_mw und renewable_share_pct pro Slot. Pro Feld eine origin-Markierung (realized/public_forecast/model_forecast). day akzeptiert today, tomorrow und YYYY-MM-DD.

{
  "day": { "label": "2026-06-01", "timezone": "Europe/Berlin", … },
  "points": [
    {
      "time": "2026-05-31T22:00:00Z",
      "values_mw": { "wind_onshore": 9094, "photovoltaic": 0, …, "natural_gas": 5743 },
      "consumption_mw": 46493,
      "renewable_share_pct": 43.1,
      "origin": { "wind_onshore": "realized", …, "natural_gas": "realized" }
    }
  ],
  "data_source": "strommix.info",
  "license": "CC-BY-4.0"
}

Aggregate: /api/v1/mix/hourly?from=YYYY-MM-DD&to=YYYY-MM-DD · /api/v1/mix/daily?from=YYYY-MM-DD&to=YYYY-MM-DD · /api/v1/mix/monthly?from=YYYY-MM&to=YYYY-MM

EE-Anteil & Strom-Ampel

GET /api/v1/renewable-share?day=YYYY-MM-DD

Prozent erneuerbarer Anteil am Verbrauch pro 15-min-Slot, plus diskretes Ampel-level: red (< 40 %) · yellow (40–60 %) · green (≥ 60 %) · blue (Überschuss, > 100 %).

{
  "points": [
    { "time": "2026-05-31T22:00:00Z", "pct": 43.1, "level": "yellow", "origin": "realized" }
  ]
}

Aggregate ebenfalls als /hourly · /daily · /monthly.

Day-Ahead-Strompreis + Europa-Benchmark

GET /api/v1/price?day=YYYY-MM-DD

DE-LU-Day-Ahead-Preis in €/MWh plus pro Slot ein Europa-Benchmark (p10/p90/verbrauchsgewichteter Mittelwert über ~39 ENTSO-E-Bidding-Zones).

{
  "points":    [ { "time": "2026-05-31T22:00:00Z", "eur_mwh": 135.39, "origin": "realized" } ],
  "benchmark": [ { "time": "2026-05-31T22:00:00Z", "p10_eur_mwh": 98.7, "p90_eur_mwh": 175.2,
                   "eu_weighted_eur_mwh": 127.6, "n_zones": 39 } ]
}

Fertige Antworten für Bots

Prosa-Zusammenfassung

GET /api/v1/summary

Ein einzelner deutscher Absatz: EE-Anteil heute (Spanne + Stunden > 60 %), Solar- und Wind-Peaks, Day-Ahead-Preisbereich. Wörtlich in Chat-Antworten zitierbar.

{
  "text": "Heute (Montag, 01.06.2026), 00:00–24:00 Europa/Berlin.
           Erneuerbarer Anteil am Verbrauch: Ø 48 %, Spanne 14–97 %, 8.2 h über 60 %.
           Solar-Peak: 44.3 GW um 13:15 Uhr. …",
  "metrics": { … }
}

Empfehlung: bestes Zeitfenster

GET /api/best-hours?duration_h=4&window=tomorrow

Bestes zusammenhängendes Fenster für eine Dauer (E-Auto, Wärmepumpe, Waschmaschine), bewertet nach EE-Anteil und Preis. Mit Begründung und Alternativen.

Parameter	Werte	Default
`duration_h`	0.25 – 24	4
`window`	`today` · `tomorrow` · `next_24h` · `next_48h`	`next_24h`
`metric`	`green_cheap` · `greenest` · `cheapest`	`green_cheap`

{
  "recommendation": "Bestes 4h-Fenster: Di 02.06. 10:45 – 14:30 · Ø EE-Anteil 84 % · Ø Day-Ahead-Preis 84 €/MWh.",
  "best_window": {
    "start": "2026-06-02T08:45:00Z",
    "end":   "2026-06-02T12:30:00Z",
    "start_local": "Di 02.06. 10:45",
    "end_local":   "14:30",
    "avg_renewable_share_pct": 84.4,
    "avg_price_eur_mwh": 84.2,
    "reason": "hoher EE-Anteil, Preis ~32 % unter Tagesmedian"
  },
  "alternatives": [ … ]
}

Konventionen

Zeitstempel	UTC im Response (`2026-05-31T22:00:00Z`), Berlin-Local für die `day`/`from`/`to`-Parameter.
Granularität	Punkt-Endpoints: 15-min. Aggregate: 1 h / 1 Tag / 1 Monat, jeweils in Europe/Berlin-Kalendergrenzen.
Einheiten	Leistung in MW (im Frontend als GW dargestellt ab 1 GW), Preis in €/MWh, Anteile in %.
`origin`	`realized` (vom Netzbetreiber gemessen) · `public_forecast` (offizielle TSO/EPEX-Prognose) · `model_forecast` (eigene ML). Priorität in Merged-Antworten: realized > public > model.
Verfügbarkeit	Bei leeren Zeiträumen ist `available: false` gesetzt und `reason` erklärt warum (z. B. „Zeitraum liegt komplett in der Zukunft").
Caching	API serverseitig Redis-cached (15 – 1800 s je nach Endpoint). Clients dürfen entsprechend wenig fragen.

Lizenz & Attribution

Alle Antworten unter CC-BY-4.0. Bitte verwende beim Weiterverarbeiten folgende Quellenangabe:

Daten: strommix.info (CC-BY-4.0), basierend auf SMARD/Bundesnetzagentur,
ENTSO-E Transparency Platform und DWD ICON-D2 (via Open-Meteo).

API