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
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 des Geschäfts filtern
"buy" | "sell"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/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."
}/orders/{order_id} DELETE
Eine offene Order löschen. Der nicht ausgeführte Rest verlässt das Orderbuch; bereits ausgeführte Geschäfte bleiben endgültig. Eine vollständig ausgeführte Order lässt sich nicht mehr löschen. Die Antwort liefert die Order mit dem Status cancelled. Erforderlicher Scope: trading:write
/listings GET
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