Forecast API
ENWEX-Indexwerte, Tagesfahrplan-Profil und Langfristprognose im API-Abruf — die Datengrundlage der indexbasierten Lieferung.
Freischaltung erforderlich
Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.
Die Forecast API liefert die ENWEX-Referenzindexe — von OES bei der Enwex GmbH lizenziert — über die Otark-Plattform: die stündlichen Indexwerte je Liefertag, das Viertelstundenprofil des Tagesfahrplans für den Folgetag und die Langfristprognose je Monat bis zum Dezember des Folgejahres. Sie richtet sich an Verkäufer und Käufer, die die Datengrundlage der indexbasierten Lieferung (Referenzindex & Liefermenge) in ihre eigenen Systeme übernehmen wollen; Bilanzkreisverantwortliche beziehen ihre Fahrplan- und Prognosedaten über BRP Connect und die BRP-Connect-API. Die Indexdaten sind lizenziert: Sie werden zur Vertragsabwicklung bereitgestellt; eine Weiterverwendung darüber hinaus ist nicht gestattet.
Basis-URL
https://api.otark.com/v1Alle Anfragen müssen HTTPS verwenden. Antworten werden im JSON-Format zurückgegeben.
Authentifizierung
Alle Anfragen müssen den X-Api-Key-Header enthalten:
curl -X GET "https://api.otark.com/v1/indexes" \
-H "X-Api-Key: IHR_API_KEY"Wie die Authentifizierung plattformweit funktioniert und wo die Schlüssel der übrigen APIs entstehen, steht unter Authentifizierung.
API-Schlüssel erstellen Sie in den Kontoeinstellungen auf app.otark.com. Alle Operationen dieser API verlangen den Scope forecasts:read. Bewahren Sie Ihren Schlüssel sicher auf.
Konventionen
| Konvention | Regel |
|---|---|
| Zeitstempel | ISO 8601 in UTC (2026-07-14T10:00:00Z); Liefertage als YYYY-MM-DD, Monate als YYYY-MM |
| Stundenzählung | 1–24 wie EPEX: Stunde 14 = 13:00–14:00 (Europe/Berlin); Viertelstunden 1–96 — am Tag der Umstellung auf Sommerzeit entfallen 9–12, am Tag der Umstellung auf Winterzeit trägt der zweite Durchlauf der wiederholten Fenster die Nummern 97–100 |
| Paginierung | Listen liefern limit und einen Cursor (after / next_cursor); Werte-, Fahrplan- und Prognoseabfragen liefern den angefragten Zeitraum vollständig |
| Fehler | Problem Details nach RFC 9457 (application/problem+json) |
| Ratenbegrenzung | 300 Anfragen je 60-Sekunden-Fenster, plattformweit gleich; die Antwort führt X-RateLimit-Limit, -Remaining und -Reset mit, bei Überschreitung 429 Too Many Requests |
Ressourcen
| Ressource | Zweck |
|---|---|
| Indexe | die beiden Referenzindexe ENWEX Solar DE und ENWEX Wind DE mit Auflösung, Einheit und Veröffentlichungszeit |
| Indexwerte | die stündlichen Indexwerte eines Liefertags in Prozent der Nennleistung |
| Tagesfahrplan | das Viertelstundenprofil des Index für einen Liefertag — jede Viertelstunde trägt den Stundenwert; die Grundlage, aus der OES die Tagesfahrpläne berechnet |
| Langfristprognose | die Indexprognose je Monat, ausgedrückt in MWh je MW Nennleistung |
Veröffentlichungszeiten
| Wann | Was |
|---|---|
| D−1, 10:00 | Enwex veröffentlicht den Index für den Liefertag D — damit stehen Indexwerte und Viertelstundenprofil (Tagesfahrplan) dieser API bereit (Referenzindex & Liefermenge) |
| D−1, 12:00 | OES stellt aus dem Profil die Tagesfahrpläne für D bereit — Transaktionen je Vertrag, Nominierungen je Bilanzkreis; jede Revision erzeugt eine neue Version (Nominierung & Tagesfahrpläne) |
Alle Zeiten Europe/Berlin. Die Langfristprognose reicht vom laufenden Monat bis zum Dezember des Folgejahres — sie ist die Grundlage der Bilanzkreis-Prognose in BRP Connect. Vertrags- und Bilanzkreisfahrpläne — Transaktionen je Vertrag, Nominierungen je Bilanzkreis — liefert die BRP-Connect-API.
Support
Bei Fragen oder für weitere Unterstützung erreichen Sie uns über den Support.
/imports/{import_id} GET
Einen CSV-Import samt Verarbeitungsstatus abrufen. completed heißt, dass alle Zeilen geschrieben wurden; failed heißt, dass keine Zeile geschrieben wurde und errors die Gründe aufführt. Erforderlicher Scope: metering:read
/indexes GET
Die ENWEX-Referenzindexe auflisten. Es gibt zwei Indexe: ENWEX Solar DE und ENWEX Wind DE — die Referenzindexe der indexbasierten Lieferung, veröffentlicht von der Enwex GmbH und von OES unter Lizenz bereitgestellt. Jeder Index bildet die prognostizierte Erzeugung der in Deutschland installierten Solar- oder Windleistung ab, stündlich aufgelöst und in Prozent der Nennleistung ausgedrückt. Die Indexdaten werden zur Vertragsabwicklung bereitgestellt; eine Verwendung darüber hinaus ist nicht gestattet. Erforderlicher Scope: forecasts:read
Zuletzt aktualisiert am