Green SPOT API

POST /v1/listings/{listing_id}/accept

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

Als Markdown anzeigen

Freischaltung erforderlich

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

In: header

Path Parameters

listing_idstring

Kennung des Inserats

quantity?integer

Anzunehmende Menge in ganzen MWh. Bleibt die Angabe weg, wird die volle offene Menge angenommen; eine Teilmenge ist nur zulässig, wenn der Inserent allow_partial gesetzt hat.

Range1 <= value

Response Body

curl -X POST "https://api.otark.com/v1/listings/lst_p5q6r7s8/accept" \  -H "Content-Type: application/json" \  -d '{}'
{
  "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/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."
}