GET /v1/bids/{bid_id}
Ein einzelnes Gebot über seine Kennung abrufen. Erforderlicher Scope: trading:read
Freischaltung erforderlich
curl -X GET "https://api.otark.com/v1/bids/bid_a1b2c3d4"{
"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"
}{
"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"
}/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
/bids/{bid_id} PUT
Menge oder Preislimit eines offenen Gebots ändern. Möglich bis zur Gate Closure um 10:30 Uhr Europe/Berlin an D−1 — danach ist das Gebot unwiderruflich bindend, und die Anfrage wird mit einem Zustandskonflikt zurückgewiesen. Die API prüft das geänderte Gebot wie ein neues: Grenzen, freies Limit und bei Verkaufsgeboten Anlage und Mengenobergrenze. Erforderlicher Scope: trading:write