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
Freischaltung erforderlich
In: header
Seite des Inserats
"buy" | "sell"Liefertag der GC (YYYY-MM-DD)
dateStunde des Liefertags (1–24 wie bei EPEX)
1 <= value <= 24Erforderlich, 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
"A" | "B"Menge in ganzen MWh
1 <= valuePreis in EUR/MWh (2 Nachkommastellen, Pflichtangabe, Boden bei 0,00)
0 <= valueDie unmittelbare Annahme von Teilmengen zulassen (Voreinstellung false)
falseResponse 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."
}/listings GET
Die Inserate auf dem Granular Aftermarket auflisten. Voreingestellt kommen alle offenen Inserate anonym zurück — Produkt, Menge und Preis, nie der Inserent. Mit own=true kommen allein die eigenen Inserate des Aufrufers, einschließlich der abgeschlossenen und zurückgezogenen. Mit include_counter_offers=true trägt jedes Inserat ein Feld counter_offers: bei eigenen Inseraten die eingegangenen Gegenangebote, bei fremden nur die eigenen des Aufrufers. Erforderlicher Scope: trading:read
/listings/{listing_id} PUT
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