Forecast API

GET /v1/indexes/{index_id}/long-term-forecast

Die monatliche Langfristprognose des Index, vom laufenden Monat bis zum Dezember des Folgejahres. Jeder Monat trägt die zur Energie aufsummierte stündliche Langfristprognose in MWh je MW Nennleistung — Vertragsleistung in MW × dieser Wert ergibt die erwartete Monatsmenge, die Grundlage der Bilanzkreis-Prognose in BRP Connect. Alle Werte sind Näherungen: Maßgeblich für die Lieferung ist der je Liefertag veröffentlichte Index, nicht die Langfristprognose. Erforderlicher Scope: forecasts:read

Als Markdown anzeigen

Freischaltung erforderlich

Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.
GET
/v1/indexes/{index_id}/long-term-forecast
X-Api-Key<token>

In: header

Path Parameters

index_idstring

Kennung des Index

Value in"enwex-solar-de" | "enwex-wind-de"

Query Parameters

from_month?string

Filter: erster einbezogener Monat (YYYY-MM). Voreinstellung ist der laufende Monat

Match^\d{4}-(0[1-9]|1[0-2])$
to_month?string

Filter: letzter einbezogener Monat (YYYY-MM). Voreinstellung ist der Dezember des Folgejahres, das Ende des Prognosehorizonts

Match^\d{4}-(0[1-9]|1[0-2])$

Response Body

curl -X GET "https://api.otark.com/v1/indexes/enwex-solar-de/long-term-forecast?from_month=2026-07&to_month=2027-12"
{
  "index_id": "enwex-solar-de",
  "as_of": "2026-06-30T08:00:00Z",
  "months": [
    {
      "month": "2026-07",
      "energy_per_mw": 158
    }
  ]
}

{
  "type": "https://api.otark.com/errors/validation",
  "title": "Validierung fehlgeschlagen",
  "status": 400,
  "instance": "/v1/indexes/enwex-solar-de/values",
  "errors": [
    {
      "field": "delivery_date",
      "code": "invalid_format",
      "message": "Invalid date. Expected YYYY-MM-DD, received '15.07.2026'"
    }
  ]
}

{
  "type": "https://api.otark.com/errors/invalid_api_key",
  "title": "Ungültiger API-Schlüssel",
  "status": 401
}

{
  "type": "https://api.otark.com/errors/insufficient_scopes",
  "title": "Unzureichende Scopes des API-Schlüssels",
  "status": 403,
  "detail": "Missing scope: forecasts:read. Please create a new API key with the required scopes."
}

{
  "type": "https://api.otark.com/errors/delivery_day_not_published",
  "title": "Liefertag nicht veröffentlicht",
  "status": 404,
  "detail": "No day schedule has been published for 2026-07-16 yet. The index for a delivery day is published at 10:00 (Europe/Berlin) on the preceding day.",
  "instance": "/v1/indexes/enwex-solar-de/day-schedule"
}