Green SPOT API

POST /v1/listings

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

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
X-Api-Key<token>

In: header

sidestring

Seite des Inserats

Value in"buy" | "sell"
delivery_datestring

Liefertag der GC (YYYY-MM-DD)

Formatdate
hourinteger

Stunde des Liefertags (1–24 wie bei EPEX)

Range1 <= value <= 24
hour_suffix?string

Erforderlich, um Stunde 3 am 25-Stunden-Tag der Umstellung auf Winterzeit anzusprechen — A (noch MESZ) oder B (schon MEZ); bei allen anderen Stunden entfällt die Angabe

Value in"A" | "B"
quantityinteger

Menge in ganzen MWh

Range1 <= value
pricenumber

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

Range0 <= value
allow_partial?boolean

Die unmittelbare Annahme von Teilmengen zulassen (Voreinstellung false)

Defaultfalse

Response Body

curl -X POST "https://api.otark.com/v1/listings" \  -H "Content-Type: application/json" \  -d '{    "side": "sell",    "delivery_date": "2026-03-18",    "hour": 14,    "quantity": 10,    "price": 5.5  }'
{
  "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/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."
}