Green SPOT API

PUT /v1/listings/{listing_id}

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

Als Markdown anzeigen

Freischaltung erforderlich

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

In: header

Path Parameters

listing_idstring

Kennung des Inserats

quantity?integer

Neue Menge in ganzen MWh

Range1 <= value
price?number

Neuer Preis in EUR/MWh (2 Nachkommastellen, Boden bei 0,00)

Range0 <= value
allow_partial?boolean

Die unmittelbare Annahme von Teilmengen zulassen

Response Body

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

Ein Inserat auf dem Granular Aftermarket (Phase 4) veröffentlichen. Ein Inserat nennt Richtung, Liefertag und Stunde, eine Menge in ganzen MWh (1 MWh = 1 HKN) und einen Preis in EUR/MWh. Die Preisangabe ist Pflicht, mit einem Boden bei 0,00 EUR/MWh, ohne Obergrenze und in Schritten von 0,01 EUR/MWh. Mit allow_partial lässt der Inserent die unmittelbare Annahme von Teilmengen zu; ohne diese Option ist das Inserat nur als Ganzes annehmbar, und kleinere Mengen verlangen ein Gegenangebot. Verkaufen darf nur, wessen HKN bei OES liegen und dessen HC verfügbar sind. Vor der Zuteilung ist je Stunde höchstens die Long-Position anbietbar, min(ausgestellte HC der Stunde; max(0; Pos(h) ohne Aftermarket-Verkäufe)), nie ein HC, das einen gehandelten Anspruch deckt. Zugeteilte und auf dem Aftermarket erworbene HC sind als nicht mehr handelbar gekennzeichnet. Ab der Veröffentlichung blockiert OES die inserierten HC phasenübergreifend: Dieselbe Menge lässt sich nicht zweimal anbieten, das zuerst eingestellte Angebot gewinnt. Beim Abschluss prüft das System das freie Limit des Käufers; reicht es nicht, kommt das Geschäft nicht zustande. Handelbar sind die Liefertage von Monatsanfang M−10 bis Monatsende M−1, bezogen auf den aktuellen Tag. Ein Liefermonat ist damit ab dem ersten Tag des Folgemonats handelbar, sobald HC ausgestellt sind (frühestens am 21. des Folgemonats), und bis zum Board-Schluss 10 Monate nach Ende des Erzeugungsmonats; an diesem Tag erlischt jedes offene Inserat. Die zwei Monate bis zur gesetzlichen HKN-Übertragungsfrist brauchen die HKN für den Weg auf das Registerkonto des Käufers. Erforderlicher Scope: trading:write

/listings/{listing_id} DELETE

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