Zum Inhalt springen

API-Dokumentation

Eine gewöhnliche REST-API: eine Adresse, ein Schlüssel im Header, JSON zurück. Jeden Endpunkt können Sie direkt hier auf der Seite ausprobieren, bevor Sie eine Zeile Code schreiben.

Basis-URL

https://api.spotforecast.eu/v1

Authentifizierungs-Header

Authorization: Bearer YOUR_KEY

Authentifizierung

Senden Sie den Schlüssel im Header, nicht in der URL. Was in der URL steht, landet im Log jedes Servers auf dem Weg und bleibt im Verlauf des Browsers - der Schlüssel kann so an Stellen gelangen, die Sie nicht verwalten und an die er nicht gehört.

bash
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://api.spotforecast.eu/v1/forecast?zone=CZ&horizon=7&unit=EUR/MWh"

Endpunkte

GET/v1/zonesOhne Schlüssel

Public. Lists the bidding zones we serve: has_forecast says whether a forecast exists for each, latest_as_of_utc carries the time of the last run and is null where nothing has been published for that zone yet.

Ausprobieren

Anfrage-URL

https://api.spotforecast.eu/v1/zones

Antwort

Parameter ausfüllen und Anfrage senden - die Antwort erscheint hier.

Einheiten

Die Preise sind in EUR/MWh, sofern die API-Anfrage keine andere Einheit verlangt. Jede Antwort nennt die Einheit, in der ihre Preise stehen. Die Preise gelten immer nur für die Energie selbst, ohne Steuern und ohne weitere feste Entgelte (Netzentgelt, Aufschläge des Spot-Tarifanbieters und so weiter).

  • EUR/MWhDie Standardeinheit. Die Prognosemodelle rechnen darin, am Eingang wie am Ausgang.
  • EUR/kWhDamit arbeitet zum Beispiel evcc.
  • ct/kWhDiese Einheit verwendet das Energie-Dashboard in Home Assistant.

Gebotszonen

Den Code im Parameter zone verwenden.

  • AlbaniaAL
  • AustriaAT
  • BelgiumBE
  • BulgariaBG
  • CroatiaHR
  • Czech RepublicCZ
  • Denmark EastDK2
  • Denmark WestDK1
  • EstoniaEE
  • FinlandFI
  • FranceFR
  • Germany-LuxembourgDE
  • GreeceGR
  • HungaryHU
  • Ireland (SEM)IE-SEM
  • Italy CalabriaIT-CALA
  • Italy Centre-NorthIT-CNOR
  • Italy Centre-SouthIT-CSUD
  • Italy NorthIT-NORD
  • Italy SardiniaIT-SARD
  • Italy SicilyIT-SICI
  • Italy SouthIT-SUD
  • KosovoXK
  • LatviaLV
  • LithuaniaLT
  • MontenegroME
  • NetherlandsNL
  • North MacedoniaMK
  • Norway NO1 (Oslo)NO1
  • Norway NO2 (Kristiansand)NO2
  • Norway NO3 (Trondheim)NO3
  • Norway NO4 (Tromso)NO4
  • Norway NO5 (Bergen)NO5
  • PolandPL
  • PortugalPT
  • RomaniaRO
  • SerbiaRS
  • SlovakiaSK
  • SloveniaSI
  • SpainES
  • Sweden SE1 (Lulea)SE1
  • Sweden SE2 (Sundsvall)SE2
  • Sweden SE3 (Stockholm)SE3
  • Sweden SE4 (Malmo)SE4
  • SwitzerlandCH

Die Spotmarktpreisdaten für Strom und die zugehörigen Prognosen richten sich nach der Ortszeit der jeweiligen Zone. Zeitstempel sind immer in UTC angegeben.

Beispielantwort

json
{
  "zone": "CZ",
  "as_of_utc": "2026-08-10T13:00:00Z",
  "model_version": "v3-CZ-D7-20260810-0835",
  "unit": "EUR/MWh",
  "resolution": "PT60M",
  "horizon_days": 7,
  "points": [
    {
      "start": "2026-08-10T22:00:00Z",
      "value": 141.86,
      "p10": 112.9,
      "p90": 205.06,
      "origin": "forecast"
    }
  ],
  "attribution": {
    "market_data": "Source of underlying market data: ENTSO-E Transparency Platform."
  }
}

Fehler

Fehler senden wir als Problem Details (RFC 9457). Jeder hat ein type-Feld mit dem Link auf die Seite, die ihn beschreibt. Fehlertexte sind Englisch.

API-Fehler

Häufige Fragen

Wie bekomme ich einen Schlüssel?

Legen Sie ein Konto per E-Mail an und erstellen Sie den Schlüssel auf der Kontoseite.

Was passiert, wenn ich das Limit überschreite?

Die Anfrage wird mit 429 und einem Retry-After-Header beantwortet, der sagt, wann sich das Fenster zurücksetzt. Jede API-Antwort enthält außerdem die Zahl der verbleibenden Anfragen.

Wozu dient die Prognosehistorie?

Für Backtests. Sie fragen ein vergangenes Datum ab und bekommen die Prognose so, wie sie für diesen Tag aussah. Außerdem können Sie selbst beurteilen, wie genau unsere Modelle sind und ob sie zu Ihrem Zweck passen.

Wie unterscheiden sich 15-Minuten- und Stundenintervalle?

Die Modelle rechnen die Prognose standardmäßig in Stundenintervallen, die 15-Minuten-Intervalle werden daraus interpoliert. Die tatsächlichen Marktpreise gibt es ebenfalls in beiden Varianten.

In welcher Einheit bekomme ich die Daten?

Standard ist EUR/MWh, in der API-Anfrage können Sie aber auch EUR/kWh oder ct/kWh wählen - die Antwort nennt die Einheit immer. Für die Anbindung an smarte Steuerungssysteme kann eine andere Einheit praktisch sein.

Wie genau sind die Prognosen?

Die Genauigkeit kann sich von Zone zu Zone unterscheiden, denn jede Zone hat ihre Eigenheiten. In manchen Zonen ist sie sehr hoch, in anderen arbeiten wir noch daran, die Modelle zu verbessern. Den Fehler messen wir als MAE (Mean Absolute Error), und der Wert steht im Prognosediagramm für jede Zone und jeden Tag. Neben der Prognosekurve geben wir außerdem ein Band aus den Perzentilen P10-P90 an, das zusätzlich zeigt, wie weit der reale Marktpreis in den Extremen von der Prognose abweichen kann.