# Green SPOT API (https://docs.otark.com/de/developer/green-spot-api)

<Callout type="warn" title="Freischaltung erforderlich">
  Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den [Support](https://docs.otark.com/de/support).
</Callout>

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](https://docs.otark.com/de/green-spot/granular-matching) und auf dem [Granular Aftermarket](https://docs.otark.com/de/green-spot/granular-aftermarket) handeln sowie Sicherheiten und Abrechnungen einsehen. Orderbuch, Auktion und Matching betreibt die Otark GmbH. [OES ist zentrale Vertragspartei](https://docs.otark.com/de/green-spot/market-roles) jedes Geschäfts und rechnet ab. Die API setzt die Regeln des [Regelwerks](https://docs.otark.com/de/green-spot) 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:

```bash
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](https://docs.otark.com/de/developer/authentication).

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](https://docs.otark.com/de/green-spot/special-cases/dst-days) 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](https://docs.otark.com/de/green-spot/certificate-price) 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)](https://docs.otark.com/de/green-spot/certificate-price) nachrechnen |
| **Day-ahead-Gebote**     | [Gebote](https://docs.otark.com/de/green-spot/bidding) je Portfolio und Viertelstunde einreichen, ändern und zurückziehen                                                                                                                                                                                                                                      |
| **Zuschläge**            | [Day-ahead-Zuschläge](https://docs.otark.com/de/green-spot/award-delivery-obligation) je Liefertag und Stunde, mit Menge und Clearingpreis jeder Viertelstunde                                                                                                                                                                                                 |
| **Positionen**           | Die [Position Pos(h)](https://docs.otark.com/de/green-spot/coverage-netting) 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](https://docs.otark.com/de/green-spot/granular-matching) 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](https://docs.otark.com/de/green-spot/granular-aftermarket) der Phase 4                                                                                                                                                                                                           |
| **Sicherheiten**         | Das [Sicherheitenkonto](https://docs.otark.com/de/green-spot/margin-calls-limits) mit hinterlegter Sicherheit, Bedarf und freiem Limit, nur lesend                                                                                                                                                                                                             |
| **Abrechnung**           | Die [Abrechnungstage](https://docs.otark.com/de/green-spot/billing-cycle) 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](https://docs.otark.com/de/green-spot/gate-closure-clearing): 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](https://docs.otark.com/de/green-spot/green-intraday) je Viertelstunde, gerechnet in UTC                                                                                                                                                                                                                                           |
| D−1, 15:00                                                                                           | Zweite Veröffentlichung: [P\_QHC(qh) und P\_HC(h)](https://docs.otark.com/de/green-spot/certificate-price) 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](https://docs.otark.com/de/green-spot/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](https://docs.otark.com/de/green-spot/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](https://docs.otark.com/de/green-spot/certificate-allocation) 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](https://docs.otark.com/de/green-spot/billing-cycle) 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](https://docs.otark.com/de/green-spot/green-intraday) sind nicht Teil dieser Spezifikation.

## Support

Bei Fragen oder für weitere Unterstützung erreichen Sie uns über den [Support](https://docs.otark.com/de/support).
