GET /v1/orders
Die Orders des Aufrufers im Orderbuch des Granular Matching auflisten. Filterbar nach Liefertag, Stunde, Seite und Status. 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 der Order filtern
"buy" | "sell"Nach dem Status der Order filtern
"open" | "filled" | "cancelled"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/orders?delivery_date=2026-03-18&hour=14&hour_suffix=A&side=buy&status=open&limit=10&after=bid_a1b2c3d4"{
"orders": [
{
"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"
}
],
"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."
}/coverage GET
Die Positionen des Aufrufers je Tupel (Liefertag, Stunde) auflisten: q_award, q_metered, q_bought, q_sold, die Short-Menge q_gap und die anbietbare Long-Menge free_position. Pos(h) = q_metered − (q_sold − q_bought); negativ heißt short, positiv long. Genettet wird je Teilnehmer über alle Portfolios, Anlagen, Technologien und die vier Viertelstunden derselben Stunde, nie über Stunden, Liefertage oder Teilnehmer hinweg. Als Ist-Wert zählen allein die abrechnungsrelevanten Messwerte des MSB (Q_metered); gemeldete oder vorläufige Werte gehen nie in die Rechnung ein, die mit jedem Dateneingang und jedem Geschäft neu läuft. Solange für eine Anlage keine Messwerte vorliegen und der Korrekturschluss am 20. des Folgemonats nicht erreicht ist, ist die Position der Stunde nicht bestimmbar und die Stunde im Granular Matching nicht handelbar. Liegen zum Korrekturschluss keine Messwerte vor, gilt Pos(h) als negative Nettoverkaufsmenge. Zum Ende des GM-Fensters (final_gate_at) stellt OES die Fehlmenge F(h) fest: die dann verbleibende Short-Menge q_gap. Erforderlicher Scope: trading:read
/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