API

Die Daten, direkt von der Plattform

Dieselbe Schicht, die auch die Seiten der Website lesen. Kein Schlüssel, keine Registrierung, JSON über HTTP. Jede Antwort sagt, aus welcher Quelle sie stammt, auf welchen Zeitpunkt sie sich bezieht und wie aktuell sie ist.

Das Stromsystem, in Echtzeit

Verbrauch, Erzeugung nach Quelle und grenzüberschreitender Austausch, wie die Übertragungsnetzbetreiber sie veröffentlichen. Offen.

Adresse Was sie liefert Takt
/api/v1/countries Jedes Land der Plattform, mit seinen Zonen und dem Stand der Abdeckung. Ändert sich selten — wenn sich das Register ändert.
/api/v1/countries/:iso2/latest Momentaufnahme eines Landes: Verbrauch, Erzeugung nach Quelle, Grenzbilanz. So oft, wie sein Betreiber veröffentlicht — von 10 Sekunden bis zu einer Stunde.
/api/v1/countries/:iso2/history Eine Zeitreihe für ein Land, über einen gewählten Zeitraum. Derselbe Takt wie die Momentaufnahme.
/api/v1/europe/latest Die europäische Summe und jedes Land, das in sie eingeht. Eine Minute.
/api/v1/status Der Stand der Datenerhebung: welche Quelle zuletzt veröffentlicht hat, und wann. Fortlaufend.
/api/v1/licenses Was die Plattform mit den Daten jeder Quelle tun darf. Wenn sich die Bedingungen einer Quelle ändern.
/api/v1/search Suche über Länder, Zonen und Begriffe. Fortlaufend.

Der Day-Ahead-Markt

Die für den Folgetag versteigerten Preise, nach Gebotszone. Vorerst geschlossen — warum, steht unten.

Adresse Was sie liefert Takt
/api/v1/prices/latest451 · Lizenz Der letzte bekannte Preis für jede Zone. Einmal täglich, nach der Auktion.
/api/v1/prices/zones451 · Lizenz Die Gebotszonen, jeweils mit Zeitzone und Währung. Ändert sich selten.
/api/v1/prices/date451 · Lizenz Jede Zone, für einen gewählten Liefertag. Täglich.
/api/v1/prices/country/:iso2451 · Lizenz Die Preise eines Landes, für jede seiner Zonen. Täglich.
/api/v1/prices/:zone/history451 · Lizenz Der Verlauf einer Zone, Intervall für Intervall. Täglich.
/api/v1/prices/:zone/summary451 · Lizenz Durchschnitt, Minimum, Maximum und Quantile nach Tag, Woche oder Monat. Täglich.
/api/v1/market/cheapest451 · Lizenz Die Zonen mit dem niedrigsten Tagesdurchschnittspreis. Täglich.
/api/v1/market/expensive451 · Lizenz Die Zonen mit dem höchsten Tagesdurchschnittspreis. Täglich.
/api/v1/market/spreads451 · Lizenz Die Differenz zwischen der günstigsten und der teuersten Stunde, je Zone. Täglich.
/api/v1/market/cheapest-window451 · Lizenz Das günstigste zusammenhängende Fenster von N Stunden in einer Zone. Täglich.
/api/v1/market/weekly451 · Lizenz Der Wochenbericht, sobald die Woche abgeschlossen ist. Wöchentlich.

Warum die Preis-Endpunkte mit 451 antworten

Die Marktdaten stammen von der ENTSO-E-Transparenzplattform. Wir erheben sie und zeigen sie auf der Website mit der Quelle neben jeder Zahl, aber sie über eine API weiterzuverbreiten ist nicht dasselbe, wie sie anzuzeigen, und die Nutzungsbedingungen sind von uns noch nicht geprüft und erfasst.

Bis dahin liefern die Preis-Endpunkte 451 — den Code für „aus rechtlichen Gründen nicht verfügbar“ — statt stillschweigend etwas auszuliefern, das wir nicht ausliefern dürfen. Das Lizenzsystem arbeitet je Quelle, nicht je Land, daher erfordert ihre Freigabe keine Codeänderung.

Regeln für gutes Benehmen

Es gibt kein Anfragelimit, und wir würden gern keines brauchen. Die Antworten tragen cache-control: Beachten Sie es, und Sie erhalten genau dieselben Zahlen, ohne zweimal zu fragen. Echtzeitdaten ändern sich nicht häufiger, als ihr Betreiber veröffentlicht — eine Anfrage pro Sekunde für ein Land, das stündlich veröffentlicht, bringt nichts Neues.

Wenn Sie die Daten öffentlich verwenden, nennen Sie die ursprüngliche Quelle (den Übertragungsnetzbetreiber oder ENTSO-E), nicht unseren Namen: Wir transportieren sie, wir erzeugen sie nicht.

Siehe auch: Datenquellen · Methodik · llms.txt