Orvio

Market Forecast API

Bringen Sie das Schweizer Signal in Ihre eigenen Systeme.

Dieselben Prognosen, die die Orvio-Plattform antreiben, über eine einfache REST-API. Richtung der Systemunausgeglichenheit und AEP, in 15-Minuten-Auflösung, alle 15 Minuten aktualisiert.

Bereits Kunde? Im Portal anmelden

Was der Feed liefert

Zwei Prognosen, ein Feed

Richtung der Systemunausgeglichenheit in MW und der AEP in EUR/MWh, je Viertelstunde ausgerichtet.

15-Minuten-Auflösung

Vier Horizonte – T-0, T-15, T-1h und D-1 –, jeder Wert mit Prognosezeitpunkt und Vorlaufzeit.

An realisierten Daten gemessen

Jede Prognose wird an realisierten Ergebnissen gemessen; die bestbewertete Prognose ist im Einsatz.

Für Maschinen gebaut

Stabiles JSON und CSV, typisierte Fehlercodes und eine request_id in jeder Antwort.

So funktioniert es

Authentifizierung

Jede Anfrage trägt einen zugriffsbeschränkten API-Schlüssel im Authorization-Header. Schlüssel werden pro Kunde ausgestellt, mit optionaler IP-Freigabeliste und Berechtigungen je Datensatz.

Jede horizonspezifische Prognose ist für ihr Zielintervall festgeschrieben. Die aktuelle operative Tabelle kann einen neu verfügbaren kürzeren Horizont auswählen, ohne eine bestehende horizonspezifische Prognose zu verändern.

Abfrage und Zeitfenster

T-0, T-15 und T-1h publizieren jede Viertelstunde, jeweils um ca. :05, :20, :35 und :50. Fragen Sie die operative Tabelle einmal pro Minute für die Live-Sicht ab, oder übergeben Sie from und to für ein festes UTC-Fenster von bis zu 31 Tagen, als JSON oder CSV.

Endpunkte

  • GET/v1/datasetsJSON catalog
  • GET/v1/datasets/{dataset_id}JSON metadata
  • GET/v1/datasets/{dataset_id}/recordsJSON records
  • GET/v1/forecasts/latestJSON latest
  • GET/v1/status/freshnessJSON status
  • GET/v1/forecast-tableJSON table
  • GET/v1/forecast-table.csvCSV table
  • GET/v1/forecast-history.csvCSV evaluation history
  • GET/v1/datasets/{dataset_id}/exports.csvCSV records
Beispielanfrage
curl -sS "https://api.orvio.ch/v1/forecast-table?from=2026-06-22T00:00:00Z&to=2026-06-22T01:00:00Z" \
  -H "Authorization: Bearer $ORVIO_API_KEY"
Beispielantwort
{
  "items": [
    {
      "target_start": "2026-06-22T00:00:00Z",
      "target_end": "2026-06-22T00:15:00Z",
      "issued_at": "2026-06-21T23:50:19Z",
      "system_imbalance_mw": -55.3804,
      "ae_price_eur_per_mwh": 131.8746,
      "currency": "EUR",
      "quality_status": "valid",
      "freshness_status": "fresh",
      "source_horizons": {
        "system_imbalance": "t15",
        "ae_price": "t15"
      },
      "notice": null
    }
  ]
}

Für KI-Agenten gebaut

Richten Sie Ihren Assistenten auf die OpenAPI-Spezifikation und den Integrationsguide aus. Felder werden nur unter /v1 ergänzt; breaking changes erscheinen unter /v2 mit Vorankündigung. Authentifizierte Kunden öffnen API Access für den kuratierten OpenAPI-Vertrag und den Integrationsguide.

Zugang zum Feed erhalten

Sagen Sie uns, was Sie betreiben, und wir richten Ihnen einen Schlüssel und die Dokumentation ein.