GET /v1/settlement-runs
Die Abrechnungstage des Aufrufers auflisten. Je Teilnehmer und Abrechnungstag saldiert OES alle an diesem Tag abgerechneten Dokumente zu einem Nettosaldo. Day-ahead-Geschäfte des Liefertags D rechnet OES an D vor 12:00 Uhr ab, Intraday-Geschäfte des Liefertags D an D+1 vor 12:00 Uhr, Geschäfte im Granular Matching und auf dem Granular Aftermarket vom Handelstag TD an TD+1 vor 12:00 Uhr. Gesondert rechnet OES die Sanktionsrechnungen am 2. des übernächsten Monats nach dem Liefermonat ab, die Abschlussrechnung mit den Entschädigungen am 10. des übernächsten Monats und das Dezember-Clearing mit dem Dezember-Abschluss am 10. Februar; auch sie gehen in den Saldo ihres Abrechnungstags ein. Die Zahlungskette hat drei Schritte, je an einem eigenen Bankarbeitstag: OES reicht den Saldo am Abrechnungstag bei der Bank ein, fällt er auf einen Nicht-Bankarbeitstag, am nächsten Bankarbeitstag. Einen Saldo zu Lasten des Teilnehmers zieht OES am Bankarbeitstag nach der Einreichung per SEPA-Lastschrift ein, einen Saldo zu seinen Gunsten überweist OES am Bankarbeitstag danach. Fällt ein Schritt auf einen Nicht-Bankarbeitstag, rücken er und alle folgenden Schritte auf die nächsten Bankarbeitstage (Beispiel: Sanktionsrechnung Sa 02.05., Einreichung Mo 04.05., Lastschrift Di 05.05.). Die Abrechnung selbst läuft an jedem Kalendertag. Den Kaufpreis eines Aftermarket-Geschäfts überweist OES dem Verkäufer erst am Bankarbeitstag nach dem festgestellten Geldeingang (TD+6). Jede Einzelforderung bleibt neben der Saldierung bestehen, fällig und besichert. Erforderlicher Scope: settlement:read
Freischaltung erforderlich
In: header
Query Parameters
Nach der Art filtern
"daily"Filter: Abrechnungstag >= diesem Wert (YYYY-MM-DD)
dateFilter: Abrechnungstag <= diesem Wert (YYYY-MM-DD)
dateHöchstzahl der Einträge pro Seite
101 <= value <= 100Cursor für die nächste Seite — den Wert next_cursor aus der vorherigen Antwort übergeben
Response Body
curl -X GET "https://api.otark.com/v1/settlement-runs?type=daily&run_date_from=2026-03-01&run_date_to=2026-03-31&limit=10&after=bid_a1b2c3d4"{
"runs": [
{
"id": "run_b7c8d9e0",
"type": "daily",
"run_date": "2026-03-18",
"period_start": "2026-03-18",
"period_end": "2026-03-18",
"net_amount": -2550,
"payment_date": "2026-03-19"
}
],
"pagination": {
"limit": 10,
"has_more": true,
"next_cursor": "bid_x9y8z7w6"
}
}{
"type": "https://api.otark.com/errors/validation",
"title": "Validierung fehlgeschlagen",
"status": 400,
"instance": "/v1/orders",
"errors": [
{
"field": "quantity",
"code": "invalid_type",
"message": "Expected number, received string"
}
]
}{
"type": "https://api.otark.com/errors/invalid_api_key",
"title": "Ungültiger API-Schlüssel",
"status": 401
}{
"type": "https://api.otark.com/errors/insufficient_scopes",
"title": "Unzureichende Scopes des API-Schlüssels",
"status": 403,
"detail": "Missing scope: trading:write. Please create a new API key with the required scopes."
}/collateral GET
Das Sicherheitenkonto lesen: hinterlegte Sicherheit (Barsicherheit oder Bankbürgschaft auf erstes Anfordern), den aktuellen Sicherheitenbedarf und das freie Limit collateral_free = collateral_posted − collateral_required. Das Limit wirkt sofort, eine Nachschussfrist und ein Mahnverfahren gibt es nicht: Gebote und Orders, die den Bedarf erhöhen, prüft die API gegen das freie Limit und weist sie zurück, wenn es nicht reicht. Käufe zur Glattstellung bleiben möglich, soweit Kaufpreis × Menge das freie Limit zuzüglich der freiwerdenden Deckungsposition der Stunde nicht übersteigt, darüber nur gegen Vorauszahlung; ist der Marktzugang gesperrt, nur mit Zustimmung von OES. Zugeschlagene Mengen, Fehlmengen und Haltebetrag des Verkäufers bemisst OES ab der Fixierung um 15:00 Uhr an D−1 mit 2 × P_ref(h), davor mit 2 × P_HC,peak. Frei wird eine Sicherheit erst, wenn die besicherte Verpflichtung erloschen ist: bei einer Zahlung mit dem festgestellten Geldeingang (bei einer Lastschrift mit Ablauf der Rückgabefrist von 3 Bankarbeitstagen nach Ausführung, bei einer Vorauszahlung per Echtzeitüberweisung mit dem Eingang), bei einer sanktionsbewehrten Pflicht mit der Glattstellung oder dem HKN-Eingang. Erforderlicher Scope: settlement:read
/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