API

Die Daten, direkt von der Plattform

Dieselbe Schicht, aus der auch die Seiten dieser Website lesen. Kein Schlüssel, keine Registrierung, JSON über HTTP. Jede Antwort nennt die Quelle, den Zeitpunkt, auf den sie sich bezieht, und wie frisch sie ist.

Das Stromsystem, in Echtzeit

Last, Erzeugung nach Energieträger und grenzüberschreitender Austausch, so wie die Übertragungsnetzbetreiber sie veröffentlichen. Offen.

Adresse Was sie liefert Takt
/api/v1/countries Jedes Land auf der Plattform, mit seinen Zonen und seinem Abdeckungsstatus. Ändert sich selten — wenn sich das Register ändert.
/api/v1/countries/:iso2/latest Die Momentaufnahme eines Landes: Last, Erzeugung nach Energieträger, Grenzsaldo. 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 Erhebung: 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 — der Grund steht unten.

Adresse Was sie liefert Takt
/api/v1/prices/latest451 · Lizenz Der zuletzt bekannte Preis jeder Zone. Einmal täglich, nach der Auktion.
/api/v1/prices/zones451 · Lizenz Die Gebotszonen, mit Zeitzone und Währung jeder einzelnen. Ä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, nach Zone. Täglich.
/api/v1/market/cheapest-window451 · Lizenz Das günstigste zusammenhängende N-Stunden-Fenster in einer Zone. Täglich.
/api/v1/market/weekly451 · Lizenz Der Wochenbericht, sobald die Woche abgeschlossen ist. Wöchentlich.

Warum die Preis-Routen 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 weiterzugeben ist nicht dasselbe wie sie anzuzeigen, und die Nutzungsbedingungen sind von uns noch nicht geprüft und hinterlegt.

Bis dahin antworten die Preis-Routen mit 451 — dem Code für „aus rechtlichen Gründen nicht verfügbar“ —, statt stillschweigend etwas zu liefern, wozu wir kein Recht haben. Das Lizenzsystem arbeitet je Quelle, nicht je Land, ihre Öffnung erfordert also keine Codeänderung.

Regeln des guten Benehmens

Es gibt kein Anfragelimit, und wir hätten gern, dass keines nötig wird. Die Antworten tragen cache-control: Beachten Sie es, und Sie erhalten genau dieselben Zahlen, ohne zweimal zu fragen. Echtzeitdaten ändern sich nicht öfter, 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 · Systemstatus · llms.txt