Green SPOT API

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

Als Markdown anzeigen

Freischaltung erforderlich

Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.
GET
/v1/settlement-runs
X-Api-Key<token>

In: header

Query Parameters

type?string

Nach der Art filtern

Value in"daily"
run_date_from?string

Filter: Abrechnungstag >= diesem Wert (YYYY-MM-DD)

Formatdate
run_date_to?string

Filter: Abrechnungstag <= diesem Wert (YYYY-MM-DD)

Formatdate
limit?integer

Höchstzahl der Einträge pro Seite

Default10
Range1 <= value <= 100
after?string

Cursor 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