Green SPOT API

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

Als Markdown anzeigen

Freischaltung erforderlich

Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.
POST
/v1/counter-offers/{counter_offer_id}/accept
X-Api-Key<token>

In: header

Path Parameters

counter_offer_idstring

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