Green SPOT API

GET /v1/prices/{delivery_date}

Das Preisblatt eines Liefertags abrufen: je Stunde den Green-SPOT-Clearingpreis p_bundle und den Graustrompreis p_grey (Day-ahead der EPEX SPOT DE/LU), beide mit der geräumten Menge je Viertelstunde auf die Stunde gewichtet, den Spread und den Zertifikatpreis p_hc. p_hc ist das mit der geräumten Menge gewichtete Mittel der vier Viertelstundenpreise P_QHC dieser Stunde. Einen Preisboden gibt es weder je Viertelstunde noch je Stunde, beide Preise können negativ sein. Jede Stunde führt ihre vier Viertelstunden in quarter_hours mit, je mit p_bundle, p_grey, spread, p_qhc und der geräumten Menge q_cleared, so dass sich p_hc nachrechnen lässt. Für eine Stunde ohne geräumte Menge sind p_hc und p_hc_source null. Aus denselben Werten ergibt sich der Referenzpreis der Sanktion: P_ref(h) ist der höhere Wert aus p_hc und dem höchsten p_qhc einer Viertelstunde mit q_cleared > 0, mindestens null; für eine Stunde ohne geräumte Menge ist P_ref(h) = 0. Er steht mit der zweiten Veröffentlichung fest, und kein späterer Abschluss bewegt ihn. Veröffentlicht wird an D−1: p_bundle und q_cleared mit der ersten Veröffentlichung um 11:00 Uhr, p_grey, spread, p_qhc und p_hc mit der zweiten um 15:00 Uhr Europe/Berlin. Liegt das EPEX-Ergebnis verspätet vor, folgt die zweite Veröffentlichung spätestens eine Stunde danach; bleibt es bis 20:00 Uhr aus, bildet die Otark GmbH den Graustrompreis aus dem Ersatz-Spread und veröffentlicht um 20:00 Uhr. Noch nicht veröffentlichte Felder sind null. Einmal veröffentlicht, stehen die Preise für den gesamten Lebenszyklus des Liefertags fest, auch bei einer nachträglichen Korrektur des EPEX-Ergebnisses. Abrechnung und Sanktion beziehen sich auf die zweite Veröffentlichung. Erforderlicher Scope: trading: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/prices/{delivery_date}
X-Api-Key<token>

In: header

Path Parameters

delivery_datestring

Liefertag (YYYY-MM-DD)

Formatdate

Response Body

curl -X GET "https://api.otark.com/v1/prices/2026-03-18"
{
  "delivery_date": "2026-03-18",
  "hours": [
    {
      "delivery_date": "2026-03-18",
      "hour": 14,
      "hour_suffix": null,
      "p_bundle": 85,
      "p_grey": 80,
      "spread": 5,
      "p_hc": 5,
      "p_hc_source": "spread",
      "quarter_hours": [
        {
          "quarter_hour": 53,
          "p_bundle": 83,
          "p_grey": 82,
          "spread": 1,
          "p_qhc": 1,
          "q_cleared": 10
        }
      ],
      "published_at": "2026-03-17T14:00:00Z"
    }
  ]
}

{
  "type": "https://api.otark.com/errors/validation",
  "title": "Validierung fehlgeschlagen",
  "status": 400,
  "instance": "/v1/orders",
  "errors": [
    {
      "field": "quantity",
      "code": "invalid_type",
      "message": "Expected number, received string"
    }
  ]
}

{
  "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: trading:write. Please create a new API key with the required scopes."
}

{
  "type": "https://api.otark.com/errors/order_not_found",
  "title": "Order nicht gefunden",
  "status": 404,
  "instance": "/v1/orders/ord_g7h8i9j0"
}