# Forecast API (https://docs.otark.com/de/developer/forecast-api)

<Callout type="warn" title="Freischaltung erforderlich">
  Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den [Support](https://docs.otark.com/de/support).
</Callout>

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](https://docs.otark.com/de/one-click-ppa/reference-index)) in ihre eigenen Systeme übernehmen wollen; Bilanzkreisverantwortliche beziehen ihre Fahrplan- und Prognosedaten über [BRP Connect](https://docs.otark.com/de/settlement/brp-connect) und die [BRP-Connect-API](https://docs.otark.com/de/developer/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/v1
```

Alle Anfragen müssen HTTPS verwenden. Antworten werden im JSON-Format zurückgegeben.

## Authentifizierung

Alle Anfragen müssen den `X-Api-Key`-Header enthalten:

```bash
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](https://docs.otark.com/de/developer/authentication).

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](https://docs.otark.com/de/one-click-ppa/reference-index))                  |
| **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](https://docs.otark.com/de/one-click-ppa/nominations)) |

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](https://docs.otark.com/de/settlement/brp-connect/forecast). Vertrags- und Bilanzkreisfahrpläne — Transaktionen je Vertrag, Nominierungen je Bilanzkreis — liefert die [BRP-Connect-API](https://docs.otark.com/de/developer/brp-connect-api).

## Support

Bei Fragen oder für weitere Unterstützung erreichen Sie uns über den [Support](https://docs.otark.com/de/support).
