1-Click PPA API
Programmatischer Zugang zu 1-Click PPA: Anfragen stellen, Angebote annehmen, Einzelverträge, Lieferdaten, Counterparties und REMIT-Modus abrufen.
Freischaltung erforderlich
Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.
Die 1-Click PPA API bildet den Weg von der Anfrage über das Angebot zur Annahme ab und stellt die Daten der laufenden Lieferung bereit. Der Anfrage-Teil richtet sich an die Händler eines Unternehmens mit aktiver Käuferrolle: Sie erstellen Anfragen an ihre Counterparties, sehen die eingehenden Angebote und nehmen an — die Annahme erzeugt den Einzelvertrag. Einzelverträge, Lieferdaten und die REMIT-Einstellung stehen Käufern und Verkäufern offen.
Basis-URL
https://api.otark.com/v1Alle Aufrufe müssen HTTPS verwenden. Antworten werden im JSON-Format zurückgegeben.
Authentifizierung
Alle Aufrufe müssen den X-Api-Key-Header enthalten:
curl -X GET "https://api.otark.com/v1/contracts" \
-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 — rfq:read, rfq:write, contracts:read, deliveries:read —, und jede Operation nennt die Scopes, die sie verlangt. Bewahren Sie Ihren Schlüssel sicher auf.
Konventionen
| Konvention | Regel |
|---|---|
| Paginierung | Listen nehmen limit (1–100, Vorgabe 10) und einen Cursor after entgegen; die Antwort führt pagination mit has_more und next_cursor |
| Zeitstempel | ISO 8601 in UTC (2026-07-15T11:00:00Z); Liefertage als YYYY-MM-DD |
| Stunden | 1–24 nach EPEX-Konvention — Stunde 14 ist 13:00–14:00 Europe/Berlin; am 25-Stunden-Tag der Winterzeit-Umstellung tritt Stunde 3 zweimal auf und wird über hour_suffix als 3A/3B unterschieden, am 23-Stunden-Tag entfällt sie |
| Mengen und Preise | Mengen in MWh (drei Nachkommastellen), Preise in EUR/MWh (zwei Nachkommastellen) |
| Fehler | application/problem+json nach RFC 9457, mit Feldfehlern bei Validierungsfehlern |
| 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 | Rolle |
|---|---|---|
| Counterparties | aktive Verbindungen und ihr Verbindungsstatus | Käufer und Verkäufer |
| Anfragen (RFQs) | erstellen — auf Wunsch mit GC-Anforderung —, einsehen, abbrechen | Käufer |
| Angebote | je Anfrage einsehen und annehmen; die Annahme erzeugt den Einzelvertrag | Käufer |
| Einzelverträge | Liste und Details, mit PDF-Dokument und Merkmal GC-unterlegt | beide |
| Lieferdaten | Indexwerte und gelieferte Mengen je Stunde und Monat | beide |
| REMIT-Einstellung | Meldemodus einsehen und einmalig wählen, einen späteren Wechsel nimmt der Support vor | beide |
Vom Klick zum Vertrag
- Eine Anfrage geht nie „an den Markt", sondern an eine explizite Empfängerliste: Verbindliche Empfänger sind aktive Counterparties mit Verkäuferrolle, indikative Empfänger brauchen keine Verbindung (Anfrage).
- Indikative Angebote sind nicht annehmbar — die API weist die Annahme eines indikativen Angebots mit
409ab; der Weg zum Geschäft führt über eine Verbindung und eine neue, verbindliche Anfrage (Angebot). - Die Annahme erzeugt den Einzelvertrag in einer untrennbaren Transaktion; das Merkmal GC-unterlegt kommt aus der Anfrage (Annahme, Granulare Zertifikate bei 1-Click PPA).
- Geld fließt direkt zwischen den Parteien: Der Verkäufer rechnet monatlich ab, der Käufer zahlt an ihn — OES liefert mit den Lieferdaten nur die Datengrundlage (Rechnungsstellung).
- REMIT: Standard ist die Meldung durch OES; die Abweichung vereinbaren die Parteien in einer Anpassungsvereinbarung, der Meldemodus in der API ist ihre technische Umsetzung und gilt je Teilnehmer für alle Verbindungen und Green SPOT (REMIT-Meldung).
Support
Bei Fragen oder für weitere Unterstützung erreichen Sie uns über den Support.
/settlement-runs/{run_id}/items GET
Die Positionen eines Abrechnungstags auflisten. Jede Position nennt ihre Art, ihre Richtung, den Liefertag, auf den sie sich bezieht, Menge, Einzelpreis und Betrag; die Summe aller Positionen ist der Nettosaldo des Abrechnungstags. Ein Day-ahead- oder Intraday-Geschäft erscheint mit zwei Positionen, Graustromanteil und Grünstromprämie, die zusammen den Kaufpreis ergeben und umsatzsteuerlich getrennt sind. Erforderlicher Scope: settlement:read
/counterparties GET
Die Counterparty-Verbindungen des angemeldeten Unternehmens samt Verbindungsstatus auflisten. Nur aktive Counterparties in der Verkäuferrolle lassen sich als verbindliche Empfänger einer Anfrage adressieren. Erforderlicher Scope: rfq:read
Zuletzt aktualisiert am