Green SPOT API

PUT /v1/orders/{order_id}

Menge oder Preislimit einer offenen Order ändern — wie das Löschen jederzeit bis zur Ausführung möglich. Der nicht ausgeführte Rest wird im Orderbuch ersetzt; bereits ausgeführte Geschäfte bleiben endgültig, und eine vollständig ausgeführte Order lässt sich nicht mehr ändern. Die API prüft die geänderte Order wie eine neue: Grenzen, freies Limit und die Position der Stunde. 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/orders/{order_id}
X-Api-Key<token>

In: header

Path Parameters

order_idstring

Kennung der Order

quantity?number

Neue Ordermenge in MWh (3 Nachkommastellen) — mindestens die bereits ausgeführte Menge

price_limit?number

Neuer Limitpreis in EUR/MWh (2 Nachkommastellen)

Range0 <= value

Response Body

curl -X PUT "https://api.otark.com/v1/orders/ord_g7h8i9j0" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "ord_g7h8i9j0",
  "side": "buy",
  "delivery_date": "2026-03-18",
  "hour": 14,
  "hour_suffix": null,
  "quantity": 4,
  "quantity_open": 1,
  "price_limit": 5.6,
  "status": "open",
  "created_at": "2026-03-20T09:03: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."
}

/orders POST

Eine Limit-Order in das anonyme Orderbuch des Granular Matching (Phase 3) einstellen. Gehandelt werden Ansprüche auf HC je Tupel (Liefertag, Stunde), allein zur Glattstellung zwischen verkaufter und gemessener Erzeugung. Das Orderbuch eines Liefertags ist von D+1, 15:00 Uhr bis zum Ablauf des letzten Kalendertags des Folgemonats (24:00 Uhr Europe/Berlin) offen, an jedem Kalendertag; eine Störung des Marktbetriebs kann das Ende verschieben. Außerhalb dieses Fensters weist die API Orders mit einem Zustandskonflikt zurück. Menge in Schritten von 0,025 MWh, Preisschritt 0,01 EUR/MWh, Preisgrenzen 0,00 bis 1.000 EUR/MWh; Orders außerhalb weist die API mit einem Validierungsfehler zurück. Kaufen darf nur, wer in der Stunde short ist (Pos(h) < 0), höchstens bis Pos(h) = 0; das letzte gekaufte Los darf die Position auf höchstens +0,025 MWh heben. Verkaufen darf nur, wer in der Stunde long ist (Pos(h) > 0), höchstens bis Pos(h) = 0. Offene Orders desselben Teilnehmers zählen auf die Grenze mit; die API prüft jede Order gegen q_gap und free_position der Position. Solange für eine Anlage keine Messwerte vorliegen und der Korrekturschluss nicht erreicht ist, ist die Stunde nicht handelbar; gemeldete oder vorläufige Werte tragen keine Order. Verkauft ein Käufer erworbene Ansprüche weiter, weist sein Nachweis die Menge als nicht grün aus. Eine risikoerhöhende Order prüft die API gegen das freie Limit. Kauforders 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. Gematcht wird nach Preis-Zeit-Priorität; eine Teilausführung ist stets zulässig, der Rest bleibt im Orderbuch. Gegenpartei jedes Abschlusses ist OES. Ein Abschluss ist verbindlich: OES hebt ihn nur bei einem offensichtlichen technischen Fehler auf (Mistrade, Antrag bis 24:00 Uhr des Handelstags) und hebt Abschlüsse zwischen Konten verbundener Unternehmen und Scheingeschäfte wie einen Mistrade auf. Erforderlicher Scope: trading:write

/orders/{order_id} DELETE

Eine offene Order löschen. Der nicht ausgeführte Rest verlässt das Orderbuch; bereits ausgeführte Geschäfte bleiben endgültig. Eine vollständig ausgeführte Order lässt sich nicht mehr löschen. Die Antwort liefert die Order mit dem Status cancelled. Erforderlicher Scope: trading:write