1-Click PPA API

1-Click PPA API

Programmatischer Zugang zu 1-Click PPA: Anfragen stellen, Angebote annehmen, Einzelverträge, Lieferdaten, Counterparties und REMIT-Modus abrufen.

Als Markdown anzeigen

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

Alle 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

KonventionRegel
PaginierungListen nehmen limit (1–100, Vorgabe 10) und einen Cursor after entgegen; die Antwort führt pagination mit has_more und next_cursor
ZeitstempelISO 8601 in UTC (2026-07-15T11:00:00Z); Liefertage als YYYY-MM-DD
Stunden1–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 PreiseMengen in MWh (drei Nachkommastellen), Preise in EUR/MWh (zwei Nachkommastellen)
Fehlerapplication/problem+json nach RFC 9457, mit Feldfehlern bei Validierungsfehlern
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

RessourceZweckRolle
Counterpartiesaktive Verbindungen und ihr VerbindungsstatusKäufer und Verkäufer
Anfragen (RFQs)erstellen — auf Wunsch mit GC-Anforderung —, einsehen, abbrechenKäufer
Angeboteje Anfrage einsehen und annehmen; die Annahme erzeugt den EinzelvertragKäufer
EinzelverträgeListe und Details, mit PDF-Dokument und Merkmal GC-unterlegtbeide
LieferdatenIndexwerte und gelieferte Mengen je Stunde und Monatbeide
REMIT-EinstellungMeldemodus einsehen und einmalig wählen, einen späteren Wechsel nimmt der Support vorbeide

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 409 ab; 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.

Zuletzt aktualisiert am