Green SPOT API

GET /v1/bids

Die Day-ahead-Gebote des Aufrufers auflisten. Filterbar nach Liefertag, Status und Richtung. Erforderlicher Scope: trading: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/bids
X-Api-Key<token>

In: header

Query Parameters

delivery_date?string

Nach Liefertag filtern (YYYY-MM-DD)

Formatdate
status?string

Nach dem Status des Gebots filtern

Value in"open" | "binding" | "withdrawn"
direction?string

Nach der Richtung des Gebots filtern

Value in"buy" | "sell"
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/bids?delivery_date=2026-03-18&status=open&direction=buy&limit=10&after=bid_a1b2c3d4"
{
  "bids": [
    {
      "id": "bid_a1b2c3d4",
      "direction": "sell",
      "portfolio_id": "portfolio_w1n2o3r4",
      "delivery_date": "2026-03-18",
      "quarter_hour": 54,
      "quantity": 6,
      "price_limit": 80,
      "status": "open",
      "created_at": "2026-03-17T08:15:00Z"
    }
  ],
  "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."
}

/prices/{delivery_date} GET

Das Preisblatt eines Liefertags abrufen: je Stunde den Green-SPOT-Clearingpreis p_bundle und den Graustrompreis p_grey (Day-ahead der EPEX SPOT DE/LU), beide mit der geräumten Menge je Viertelstunde auf die Stunde gewichtet, den Spread und den Zertifikatpreis p_hc. p_hc ist das mit der geräumten Menge gewichtete Mittel der vier Viertelstundenpreise P_QHC dieser Stunde. Einen Preisboden gibt es weder je Viertelstunde noch je Stunde, beide Preise können negativ sein. Jede Stunde führt ihre vier Viertelstunden in quarter_hours mit, je mit p_bundle, p_grey, spread, p_qhc und der geräumten Menge q_cleared, so dass sich p_hc nachrechnen lässt. Für eine Stunde ohne geräumte Menge sind p_hc und p_hc_source null. Aus denselben Werten ergibt sich der Referenzpreis der Sanktion: P_ref(h) ist der höhere Wert aus p_hc und dem höchsten p_qhc einer Viertelstunde mit q_cleared > 0, mindestens null; für eine Stunde ohne geräumte Menge ist P_ref(h) = 0. Er steht mit der zweiten Veröffentlichung fest, und kein späterer Abschluss bewegt ihn. Veröffentlicht wird an D−1: p_bundle und q_cleared mit der ersten Veröffentlichung um 11:00 Uhr, p_grey, spread, p_qhc und p_hc mit der zweiten um 15:00 Uhr Europe/Berlin. Liegt das EPEX-Ergebnis verspätet vor, folgt die zweite Veröffentlichung spätestens eine Stunde danach; bleibt es bis 20:00 Uhr aus, bildet die Otark GmbH den Graustrompreis aus dem Ersatz-Spread und veröffentlicht um 20:00 Uhr. Noch nicht veröffentlichte Felder sind null. Einmal veröffentlicht, stehen die Preise für den gesamten Lebenszyklus des Liefertags fest, auch bei einer nachträglichen Korrektur des EPEX-Ergebnisses. Abrechnung und Sanktion beziehen sich auf die zweite Veröffentlichung. Erforderlicher Scope: trading:read

/bids POST

Ein Day-ahead-Gebot für eine Viertelstunde eines Liefertags abgeben, auf beiden Marktseiten je Portfolio. Mehrere Gebote desselben Teilnehmers für dieselbe Viertelstunde fasst die Auktion zu einer stückweise linearen Gebotskurve zusammen. Blockgebote und Alles-oder-nichts-Bedingungen gibt es nicht, Teilzuschläge sind stets zulässig. Menge in Schritten von 0,1 MW je Viertelstunde (0,025 MWh), mindestens 0,1 MW; Preisschritt 0,01 EUR/MWh, Preisgrenzen −500 bis 4.000 EUR/MWh. Gebote außerhalb weist die API mit einem Validierungsfehler zurück. Bieten darf nur, wer zugelassen ist, Sicherheit hinterlegt hat, ein gültiges SEPA-Firmenlastschriftmandat führt und nicht gesperrt ist. Jedes Gebot bindet Sicherheit: Ein Gebot, das den Sicherheitenbedarf erhöht, prüft die API gegen das freie Limit und weist es zurück, wenn es nicht reicht. Ein Verkaufsgebot verlangt eine aktive, nicht gesperrte Anlage im Portfolio; aus einem erworbenen Anspruch lässt sich im Day-ahead nicht verkaufen. Aus Erzeugung darf ein Verkäufer je Portfolio und Viertelstunde höchstens die Nettonennleistung seiner aktiven Anlagen laut MaStR × 0,25 h verkaufen, offene Verkaufsgebote, Zuschläge und Intraday-Verkäufe aus Erzeugung zusammengerechnet; ein Verkauf aus Bestand zählt nicht mit. Ein Gebot darüber weist die API zurück. Gebote lassen sich bis zur Gate Closure um 10:30 Uhr Europe/Berlin an D−1 ändern und zurückziehen; mit der Gate Closure werden sie unwiderruflich bindend. Erforderlicher Scope: trading:write