Green SPOT API

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

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/{run_id}/items
X-Api-Key<token>

In: header

Path Parameters

run_idstring

Kennung des Abrechnungstags

Query Parameters

item_type?string

Nach der Art der Position filtern

Value in"grey_share" | "certificate_instalment" | "cash_compensation" | "compensation_credit" | "aftermarket_settlement"
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/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.