Green SPOT API

GET /v1/trades

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

Als Markdown anzeigen

Freischaltung erforderlich

Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.
GET
/v1/trades
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 Geschäfts 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/trades?delivery_date=2026-03-18&hour=14&hour_suffix=A&side=buy&limit=10&after=bid_a1b2c3d4"
{
  "trades": [
    {
      "id": "trd_k1l2m3n4",
      "order_id": "ord_g7h8i9j0",
      "side": "buy",
      "delivery_date": "2026-03-18",
      "hour": 14,
      "hour_suffix": null,
      "quantity": 2,
      "price": 5.4,
      "amount": 10.8,
      "executed_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."
}