GET /v1/listings
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
Freischaltung erforderlich
In: header
Query Parameters
Nach Liefertag filtern (YYYY-MM-DD)
dateNach der Stunde des Liefertags filtern (1–24 wie bei EPEX; Stunde 14 = 13:00–14:00 Uhr Europe/Berlin). Tage der Zeitumstellung folgen der EPEX-Konvention — 23 Stunden bei der Umstellung auf Sommerzeit (Stunde 3 entfällt), 25 bei der Umstellung auf Winterzeit (Stunde 3 doppelt als 3A/3B, unterschieden über hour_suffix).
1 <= value <= 24Unterscheidet die doppelte Stunde 3 am 25-Stunden-Tag der Umstellung auf Winterzeit — A (noch MESZ) oder B (schon MEZ). Nur zusammen mit hour=3 an diesem Liefertag sinnvoll.
"A" | "B"Nach der Seite des Inserats filtern
"buy" | "sell"Nur die eigenen Inserate des Aufrufers liefern (alle Status)
"false""true" | "false"Ein Feld counter_offers je Inserat aufnehmen
"false""true" | "false"Höchstzahl der Einträge pro Seite
101 <= value <= 100Cursor für die nächste Seite — den Wert next_cursor aus der vorherigen Antwort übergeben
Response Body
curl -X GET "https://api.otark.com/v1/listings?delivery_date=2026-03-18&hour=14&hour_suffix=A&side=buy&own=true&include_counter_offers=true&limit=10&after=bid_a1b2c3d4"{
"listings": [
{
"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"
}
],
"pagination": {
"limit": 10,
"has_more": true,
"next_cursor": "bid_x9y8z7w6"
}
}{
"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."
}/trades GET
Die ausgeführten Geschäfte des Aufrufers im Granular Matching auflisten. Der Markt sieht jedes Geschäft nur mit Preis und Menge, ohne die Beteiligten; dieser Endpunkt liefert die eigenen Geschäfte des Aufrufers samt ihrer Order-Referenz. Die Positionen rechnet die API nach jedem Geschäft neu. Erforderlicher Scope: trading:read
/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