Green SPOT API

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

Als Markdown anzeigen

Freischaltung erforderlich

Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.
GET
/v1/listings
X-Api-Key<token>

In: header

Query Parameters

delivery_date?string

Nach Liefertag filtern (YYYY-MM-DD)

Formatdate
hour?integer

Nach 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).

Range1 <= value <= 24
hour_suffix?string

Unterscheidet 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.

Value in"A" | "B"
side?string

Nach der Seite des Inserats filtern

Value in"buy" | "sell"
own?string

Nur die eigenen Inserate des Aufrufers liefern (alle Status)

Default"false"
Value in"true" | "false"
include_counter_offers?string

Ein Feld counter_offers je Inserat aufnehmen

Default"false"
Value in"true" | "false"
limit?integer

Höchstzahl der Einträge pro Seite

Default10
Range1 <= value <= 100
after?string

Cursor 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