DELETE /v1/bids/{bid_id}
Ein offenes Gebot zurückziehen. 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 Antwort liefert das Gebot mit dem Status withdrawn. Erforderlicher Scope: trading:write
Freischaltung erforderlich
curl -X DELETE "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"
}{
"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."
}/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
/awards GET
Die Day-ahead-Zuschläge des Aufrufers je Liefertag und Stunde auflisten. quantity ist Q_award(h), die Summe der vier Viertelstundenzuschläge, price der Stunden-Clearingpreis p_bundle(h). Das Tupel jedes Zuschlags ist (Liefertag, Viertelstunde): Lieferverpflichtung und Kaufpreis entstehen je Viertelstunde und stehen im Feld quarter_hours mit Menge und Clearingpreis. Die Otark GmbH teilt jedem Teilnehmer seine Zuschläge einzeln mit der ersten Veröffentlichung um 11:00 Uhr Europe/Berlin an D−1 mit; teilnehmerbezogene Ergebnisse veröffentlicht sie nie. Erforderlicher Scope: trading:read