Green SPOT API
Handels-API für Green SPOT: Preise, Gebote, Zuschläge, Positionen, Granular Matching, Granular Aftermarket, Sicherheiten und Abrechnung.
Freischaltung erforderlich
Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.
Die Green SPOT API gibt zugelassenen Teilnehmern, Käufern wie Verkäufern, programmatischen Zugang zum Handel: Preise lesen, Day-ahead-Gebote einreichen, Zuschläge und die Position je Stunde verfolgen, im Granular Matching und auf dem Granular Aftermarket handeln sowie Sicherheiten und Abrechnungen einsehen. Orderbuch, Auktion und Matching betreibt die Otark GmbH. OES ist zentrale Vertragspartei jedes Geschäfts und rechnet ab. Die API setzt die Regeln des Regelwerks durch und ändert sie nicht.
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/prices/2026-03-18" \
-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. Jeder Schlüssel trägt Scopes, die den Zugriff begrenzen:
| Scope | Zugriff |
|---|---|
trading:read | Preise, Gebote, Zuschläge, Positionen, Orders, Abschlüsse und Angebote lesen |
trading:write | Gebote, Orders und Inserate anlegen, ändern und zurückziehen, Gegenangebote abgeben und annehmen |
settlement:read | Sicherheitenkonto und Abrechnungen lesen |
Konventionen
| Konvention | Regel |
|---|---|
| Zeitstempel | ISO 8601 in UTC (2026-03-18T12:00:00Z); Liefertage als YYYY-MM-DD; die Fristen des Regelwerks gelten in Europe/Berlin |
| Stunden und Viertelstunden | Stunden 1–24 wie an der EPEX (Stunde 14 = 13:00–14:00 lokal), Viertelstunden 1–96; an Umstellungstagen 23 Stunden und 92 QH (Stunde 3 entfällt) oder 25 Stunden und 100 QH (Stunde 3 als 3A/3B, im Feld hour_suffix) |
| Mengen und Preise | Mengen in MWh mit bis zu drei Nachkommastellen, Preise in EUR/MWh mit zwei Nachkommastellen; der Granular Aftermarket handelt ganze MWh |
| Paginierung | Listen nehmen limit (1–100, Vorgabe 10) und einen Cursor after entgegen; die Antwort führt pagination mit has_more und next_cursor |
| 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 |
|---|---|
| Preise | P_bundle, P_grey und der Zertifikatpreis P_HC je Liefertag und Stunde, jede Stunde mit ihren vier Viertelstundenwerten, dazu P_QHC und die je Viertelstunde geräumte Menge als Gewicht. Daraus lassen sich P_HC und der Referenzpreis P_ref(h) nachrechnen |
| Day-ahead-Gebote | Gebote je Portfolio und Viertelstunde einreichen, ändern und zurückziehen |
| Zuschläge | Day-ahead-Zuschläge je Liefertag und Stunde, mit Menge und Clearingpreis jeder Viertelstunde |
| Positionen | Die Position Pos(h) je Liefertag und Stunde: Q_award, Q_metered, alle Käufe und Verkäufe der Stunde und die Position nach Netting der vier Viertelstunden |
| Granular Matching | Limit-Orders und Abschlüsse im anonymen Orderbuch der Phase 3. Kaufen darf nur, wer short ist, verkaufen nur, wer long ist, jeweils bis Pos(h) = 0 |
| Granular Aftermarket | Angebote und Gegenangebote für ausgestellte HC auf dem Granular Aftermarket der Phase 4 |
| Sicherheiten | Das Sicherheitenkonto mit hinterlegter Sicherheit, Bedarf und freiem Limit, nur lesend |
| Abrechnung | Die Abrechnungstage mit ihrem Nettosaldo und ihren Positionen, nur lesend |
Fristen & Fenster
Die API setzt die Fristen des Regelwerks durch und weist Anfragen außerhalb eines Fensters ab:
| Zeitpunkt | Was gilt |
|---|---|
| D−1, 10:30 | Gate Closure: Alle Day-ahead-Gebote sind unwiderruflich verbindlich |
| D−1, 11:00 | Erste Veröffentlichung: Clearingpreise und die eigenen Zuschläge |
| D−1, 12:00 bis 120 Minuten vor Lieferbeginn der Viertelstunde | Handelsfenster des Green Intraday je Viertelstunde, gerechnet in UTC |
| D−1, 15:00 | Zweite Veröffentlichung: P_QHC(qh) und P_HC(h) für alle Viertelstunden und Stunden von D, damit steht auch der Referenzpreis P_ref(h) fest; alle Werte gelten für den gesamten Lebenszyklus des Liefertags |
| D+1, 15:00 bis zum Ablauf des letzten Kalendertags des Folgemonats (24:00) | Handelsfenster des Granular Matching für alle Lieferstunden von D. Zum Ende des GM-Fensters stellt OES die Fehlmenge F(h) fest |
| 1. des Folgemonats bis Ende M+10 | Granular Aftermarket für die Liefertage des Monats M, sobald HC ausgestellt sind (frühestens am 21. des Folgemonats); Angebote erlöschen spätestens mit dem Board-Schluss 10 Monate nach Ende des Erzeugungsmonats |
| 10. M+2 | Monatsabschluss: Zuteilung der GC und automatische Übertragung von HKN und GC auf das benannte HKNR-Konto und das GCR-Konto jedes Käufers, bei Verknüpfung auf das GCR-Konto seines Dienstleisters |
| täglich | Abrechnung zum Abschlusspreis: Day-ahead an D vor 12:00 (Lastschrift D+1, Überweisung D+2), Intraday an D+1, Granular Matching und Aftermarket an TD+1. Einreichung bei der Bank, Lastschrift und Überweisung brauchen je einen eigenen Bankarbeitstag; ein Wochenende oder Feiertag verschiebt die ganze Kette |
Endpunkte für den Intraday-Handel sind nicht Teil dieser Spezifikation.
Support
Bei Fragen oder für weitere Unterstützung erreichen Sie uns über den Support.
/fractional-account GET
Den aktuellen Restsaldo des angemeldeten Teilnehmers abrufen: die Differenz zwischen seinem GCR-Konto bei OES (drei Nachkommastellen) und den auf sein HKNR-Konto übertragenen HKN (ganze HKN) im laufenden Kalenderjahr. Im Monatsabschluss überträgt OES die abgerundete kumulierte GC-Menge des Jahres abzüglich der schon übertragenen HKN, je Käufer über alle Anlagen; der Rest rollt in den Folgemonat. Mit dem Dezember-Abschluss am 10. Februar erhält der Käufer für den offenen Restsaldo den Jahresreferenzpreis P_year in bar, oder OES liefert als Backup einen HKN desselben Erzeugungsmonats aus einer anderen Anlage; ein unterjährig ausgeschiedener Käufer ebenso. Einen Verfall gibt es nicht. Erforderlicher Scope: proofs:read
/prices/{delivery_date} GET
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
Zuletzt aktualisiert am