Green SPOT API

Green SPOT API

Handels-API für Green SPOT: Preise, Gebote, Zuschläge, Positionen, Granular Matching, Granular Aftermarket, Sicherheiten und Abrechnung.

Als Markdown anzeigen

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/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:

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:

ScopeZugriff
trading:readPreise, Gebote, Zuschläge, Positionen, Orders, Abschlüsse und Angebote lesen
trading:writeGebote, Orders und Inserate anlegen, ändern und zurückziehen, Gegenangebote abgeben und annehmen
settlement:readSicherheitenkonto und Abrechnungen lesen

Konventionen

KonventionRegel
ZeitstempelISO 8601 in UTC (2026-03-18T12:00:00Z); Liefertage als YYYY-MM-DD; die Fristen des Regelwerks gelten in Europe/Berlin
Stunden und ViertelstundenStunden 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 PreiseMengen in MWh mit bis zu drei Nachkommastellen, Preise in EUR/MWh mit zwei Nachkommastellen; der Granular Aftermarket handelt ganze MWh
PaginierungListen nehmen limit (1–100, Vorgabe 10) und einen Cursor after entgegen; die Antwort führt pagination mit has_more und next_cursor
FehlerProblem Details nach RFC 9457 (application/problem+json)
Ratenbegrenzung300 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

RessourceZweck
PreiseP_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-GeboteGebote je Portfolio und Viertelstunde einreichen, ändern und zurückziehen
ZuschlägeDay-ahead-Zuschläge je Liefertag und Stunde, mit Menge und Clearingpreis jeder Viertelstunde
PositionenDie 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 MatchingLimit-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 AftermarketAngebote und Gegenangebote für ausgestellte HC auf dem Granular Aftermarket der Phase 4
SicherheitenDas Sicherheitenkonto mit hinterlegter Sicherheit, Bedarf und freiem Limit, nur lesend
AbrechnungDie 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:

ZeitpunktWas gilt
D−1, 10:30Gate Closure: Alle Day-ahead-Gebote sind unwiderruflich verbindlich
D−1, 11:00Erste Veröffentlichung: Clearingpreise und die eigenen Zuschläge
D−1, 12:00 bis 120 Minuten vor Lieferbeginn der ViertelstundeHandelsfenster des Green Intraday je Viertelstunde, gerechnet in UTC
D−1, 15:00Zweite 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+10Granular 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+2Monatsabschluss: 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äglichAbrechnung 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