Green SPOT API

GET /v1/coverage

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

Als Markdown anzeigen

Freischaltung erforderlich

Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.
GET
/v1/coverage
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"
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/coverage?delivery_date=2026-03-18&hour=14&hour_suffix=A&limit=10&after=bid_a1b2c3d4"
{
  "positions": [
    {
      "delivery_date": "2026-03-18",
      "hour": 14,
      "hour_suffix": null,
      "q_award": 20,
      "q_metered": 16,
      "q_bought": 3,
      "q_sold": 20,
      "q_gap": 1,
      "free_position": 0,
      "matching_opens_at": "2026-03-19T14:00:00Z",
      "final_gate_at": "2026-04-30T22: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."
}