POST /v1/counter-offers/{counter_offer_id}/accept
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
Freischaltung erforderlich
In: header
Path Parameters
Kennung des Gegenangebots
Response Body
curl -X POST "https://api.otark.com/v1/counter-offers/cof_t9u0v1w2/accept"{
"id": "btr_x3y4z5a6",
"listing_id": "lst_p5q6r7s8",
"counter_offer_id": "cof_t9u0v1w2",
"side": "sell",
"delivery_date": "2026-03-18",
"hour": 14,
"hour_suffix": null,
"quantity": 8,
"price": 5.2,
"amount": 41.6,
"status": "awaiting_payment",
"concluded_at": "2026-04-23T10: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."
}/listings/{listing_id}/counter-offers POST
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
/collateral GET
Das Sicherheitenkonto lesen: hinterlegte Sicherheit (Barsicherheit oder Bankbürgschaft auf erstes Anfordern), den aktuellen Sicherheitenbedarf und das freie Limit collateral_free = collateral_posted − collateral_required. Das Limit wirkt sofort, eine Nachschussfrist und ein Mahnverfahren gibt es nicht: Gebote und Orders, die den Bedarf erhöhen, prüft die API gegen das freie Limit und weist sie zurück, wenn es nicht reicht. Käufe zur Glattstellung bleiben möglich, soweit Kaufpreis × Menge das freie Limit zuzüglich der freiwerdenden Deckungsposition der Stunde nicht übersteigt, darüber nur gegen Vorauszahlung; ist der Marktzugang gesperrt, nur mit Zustimmung von OES. Zugeschlagene Mengen, Fehlmengen und Haltebetrag des Verkäufers bemisst OES ab der Fixierung um 15:00 Uhr an D−1 mit 2 × P_ref(h), davor mit 2 × P_HC,peak. Frei wird eine Sicherheit erst, wenn die besicherte Verpflichtung erloschen ist: bei einer Zahlung mit dem festgestellten Geldeingang (bei einer Lastschrift mit Ablauf der Rückgabefrist von 3 Bankarbeitstagen nach Ausführung, bei einer Vorauszahlung per Echtzeitüberweisung mit dem Eingang), bei einer sanktionsbewehrten Pflicht mit der Glattstellung oder dem HKN-Eingang. Erforderlicher Scope: settlement:read