POST /v1/listings/{listing_id}/counter-offers
Ein Gegenangebot auf ein Inserat abgeben — ein anderer Preis, eine kleinere Menge als die offene Menge des Inserats oder beides. Ein Gegenangebot bindet den Anbietenden 72 Stunden; die Frist ist systemseitig fest und nicht individuell einstellbar. Danach erlischt es von selbst. Mehrere Gegenangebote auf dasselbe Inserat sind gleichzeitig zulässig. Ein Gegenangebot, das nicht mehr zum Inserat passt — etwa weil dessen Restmenge kleiner geworden ist als die angebotene —, wird automatisch zurückgewiesen. Beim Abschluss prüft das System das freie Limit des Käufers; reicht es nicht, kommt das Geschäft nicht zustande. Erforderlicher Scope: trading:write
Freischaltung erforderlich
In: header
Path Parameters
Kennung des Inserats
Menge in ganzen MWh — höchstens die offene Menge des Inserats
1 <= valuePreis in EUR/MWh (2 Nachkommastellen)
0 <= valueResponse Body
curl -X POST "https://api.otark.com/v1/listings/lst_p5q6r7s8/counter-offers" \ -H "Content-Type: application/json" \ -d '{ "quantity": 8, "price": 5.2 }'{
"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"
}{
"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/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}/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
/counter-offers/{counter_offer_id}/accept POST
Ein Gegenangebot auf ein eigenes Inserat annehmen, innerhalb seiner Bindefrist. Das Geschäft kommt über Menge und Preis des Gegenangebots zustande; der Rest des Inserats bleibt zum ursprünglichen Preis stehen. Abgewickelt wird wie jedes Aftermarket-Geschäft: Zug um Zug, Lastschrift an TD+2, Übertragung von HC und HKN und Überweisung an den Verkäufer erst nach dem festgestellten Geldeingang. Erforderlicher Scope: trading:write