DELETE /v1/listings/{listing_id}
Ein eigenes Inserat löschen. Möglich, solange es nicht angenommen ist; die Blockierung der inserierten HC endet. Offene Gegenangebote auf das Inserat weist die API automatisch zurück. Die Antwort liefert das Inserat mit dem Status withdrawn. Erforderlicher Scope: trading:write
Freischaltung erforderlich
curl -X DELETE "https://api.otark.com/v1/listings/lst_p5q6r7s8"{
"id": "lst_p5q6r7s8",
"side": "sell",
"delivery_date": "2026-03-18",
"hour": 14,
"hour_suffix": null,
"quantity": 10,
"quantity_open": 2,
"price": 5.5,
"allow_partial": false,
"status": "open",
"expires_on": "2027-01-31",
"counter_offers": [
{
"id": "cof_t9u0v1w2",
"listing_id": "lst_p5q6r7s8",
"quantity": 8,
"price": 5.2,
"status": "open",
"binds_until": "2026-04-25T09:30:00Z",
"created_at": "2026-04-22T09:30:00Z"
}
],
"created_at": "2026-04-22T09:00: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."
}/listings/{listing_id} PUT
Menge, Preis oder die Option zur Teilannahme eines eigenen Inserats ändern — wie das Löschen möglich, solange es nicht angenommen ist. Bei einem Verkaufsinserat prüft die API die geänderte Menge erneut, und die Blockierung der HC folgt der neuen Menge. Ein offenes Gegenangebot, das nicht mehr zum geänderten Inserat passt (etwa weil die neue Menge kleiner ist als die angebotene), weist die API automatisch zurück. Erforderlicher Scope: trading:write
/listings/{listing_id}/accept POST
Ein offenes Inserat zu seinem Preis annehmen. Ohne Mengenangabe im Body umfasst die Annahme die volle offene Menge; eine Teilmenge in ganzen MWh ist nur zulässig, wenn der Inserent allow_partial gesetzt hat — der Rest bleibt inseriert. Beim Abschluss prüft das System das freie Limit des Käufers. Reicht es nicht, kommt das Geschäft nicht zustande. Kommt es zustande, belegt der Kaufpreis das Limit des Käufers bis zum Ende der Abwicklung. Abgewickelt wird Zug um Zug: OES rechnet das Geschäft an TD+1 ab und zieht den Kaufpreis an TD+2 per Lastschrift ein. Nach dem festgestellten Geldeingang (TD+5) überträgt OES HC und HKN auf das GCR-Konto und das benannte HKNR-Konto des Käufers und überweist den Kaufpreis am Bankarbeitstag danach (TD+6) an den Verkäufer. Scheitert der Einzug, entfällt das Geschäft mit Ablauf der Frist nach Rückgabe der Lastschrift ohne weitere Erklärung: OES hebt die Blockierung auf, der Verkäufer kann die HC erneut anbieten, und der Käufer trägt Gebotssperre, Bankgebühren und Bearbeitungsentgelt. Ein Zukauf auf dem Aftermarket zählt im Nachweis des Käufers als datierter Nachtrag und ändert keine Sanktion. Erforderlicher Scope: trading:write