GET /v1/bids
Die Day-ahead-Gebote des Aufrufers auflisten. Filterbar nach Liefertag, Status und Richtung. Erforderlicher Scope: trading:read
Freischaltung erforderlich
In: header
Query Parameters
Nach Liefertag filtern (YYYY-MM-DD)
dateNach dem Status des Gebots filtern
"open" | "binding" | "withdrawn"Nach der Richtung des Gebots filtern
"buy" | "sell"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/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