POST /v1/bids
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
Freischaltung erforderlich
In: header
Richtung des Gebots
"buy" | "sell"Portfolio, für das geboten wird
Liefertag (YYYY-MM-DD)
dateViertelstunde des Liefertags (1–96, an Tagen der Zeitumstellung bis 100)
1 <= value <= 100Gebotsmenge in MWh für die Viertelstunde (3 Nachkommastellen). Das Regelwerk nennt Mindestmenge und Schrittweite im Day-ahead in MW — 0,1 MW je Gebot, in Schritten von 0,1 MW —, was je Viertelstunde Vielfachen von 0,025 MWh entspricht; Mengen außerhalb dieses Rasters werden zurückgewiesen.
Limitpreis in EUR/MWh (2 Nachkommastellen)
Response Body
curl -X POST "https://api.otark.com/v1/bids" \ -H "Content-Type: application/json" \ -d '{ "direction": "sell", "delivery_date": "2026-03-18", "quarter_hour": 54, "quantity": 6, "price_limit": 80 }'{
"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/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/gate_closed",
"title": "Gate Closure überschritten",
"status": 409,
"detail": "The day-ahead gate for delivery day 2026-03-18 closed at 10:30 Europe/Berlin. Bids can no longer be changed or withdrawn."
}