Green SPOT API

GET /v1/awards

Die Day-ahead-Zuschläge des Aufrufers je Liefertag und Stunde auflisten. quantity ist Q_award(h), die Summe der vier Viertelstundenzuschläge, price der Stunden-Clearingpreis p_bundle(h). Das Tupel jedes Zuschlags ist (Liefertag, Viertelstunde): Lieferverpflichtung und Kaufpreis entstehen je Viertelstunde und stehen im Feld quarter_hours mit Menge und Clearingpreis. Die Otark GmbH teilt jedem Teilnehmer seine Zuschläge einzeln mit der ersten Veröffentlichung um 11:00 Uhr Europe/Berlin an D−1 mit; teilnehmerbezogene Ergebnisse veröffentlicht sie nie. 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/awards
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"
direction?string

Nach der Seite des Zuschlags filtern

Value in"buy" | "sell"
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/awards?delivery_date=2026-03-18&hour=14&hour_suffix=A&direction=buy&limit=10&after=bid_a1b2c3d4"
{
  "awards": [
    {
      "id": "awd_c3d4e5f6",
      "direction": "sell",
      "portfolio_id": "portfolio_w1n2o3r4",
      "delivery_date": "2026-03-18",
      "hour": 14,
      "hour_suffix": null,
      "quantity": 20,
      "price": 85,
      "quarter_hours": [
        {
          "quarter_hour": 53,
          "quantity": 4,
          "price": 83
        }
      ],
      "awarded_at": "2026-03-17T10: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."
}