GET /v1/settlement-runs/{run_id}/items
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
Freischaltung erforderlich
In: header
Path Parameters
Kennung des Abrechnungstags
Query Parameters
Nach der Art der Position filtern
"grey_share" | "certificate_instalment" | "cash_compensation" | "compensation_credit" | "aftermarket_settlement"Hö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/run_b7c8d9e0/items?item_type=grey_share&limit=10&after=bid_a1b2c3d4"{
"items": [
{
"id": "itm_f1g2h3i4",
"run_id": "run_b7c8d9e0",
"item_type": "grey_share",
"direction": "debit",
"delivery_date": "2026-03-18",
"hour": 14,
"hour_suffix": null,
"quantity": 30,
"unit_price": 80,
"amount": 2400
}
],
"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."
}{
"type": "https://api.otark.com/errors/order_not_found",
"title": "Order nicht gefunden",
"status": 404,
"instance": "/v1/orders/ord_g7h8i9j0"
}/settlement-runs GET
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
Übersicht
Programmatischer Zugang zu 1-Click PPA: Anfragen stellen, Angebote annehmen, Einzelverträge, Lieferdaten, Counterparties und REMIT-Modus abrufen.