POST /v1/rfqs
Eine Anfrage anlegen. Die Anfrage geht an einen ausdrücklichen Empfängerkreis — verbindliche Empfänger sind aktive Counterparties in der Verkäuferrolle; indikative Empfänger brauchen keine Verbindung, und ihre Angebote sind nicht annehmbar. Ist granular_certificates gesetzt, darf die Anfrage nur an Verkäufer gehen, die granulare Zertifikate anbieten; jeder Empfänger sieht die Anforderung, und der mit der Annahme entstehende Einzelvertrag trägt das Merkmal GC-unterlegt. Die Empfänger werden mit dem Anlegen benachrichtigt. Ohne publication wird die Anfrage sofort veröffentlicht; mit geplanter Veröffentlichungszeit bleibt sie bis dahin scheduled. Das Angebotsfenster läuft ab der Veröffentlichung. Nach der Veröffentlichung stehen Energieträger, Lieferperiode und Leistung fest — die Verkäufer haben darauf angeboten. Die Empfängerliste steht mit dem Anlegen fest. Erforderlicher Scope: rfq:write
Freischaltung erforderlich
In: header
Energieträger — bestimmt den Referenzindex (ENWEX Solar DE oder ENWEX Wind DE)
"solar" | "wind"Kennung der Lieferperiode aus der Liste der handelbaren Perioden, etwa 2026-Q3 für ein Quartal oder 2027 für ein Jahr. Sie muss eine der derzeit handelbaren Perioden sein; genau eine je Anfrage.
Vertragsleistung in MW (mindestens 1, Schrittweite 0,01)
1 <= valueZulässige Abweichung der angebotenen Leistung in Prozent, nach oben und nach unten. 0 heißt, dass nur Angebote mit genau der angefragten Leistung zulässig sind.
00 <= value <= 100Lieferung mit granularen Zertifikaten verlangen. Ist der Wert gesetzt, darf die Anfrage nur an Verkäufer gehen, die granulare Zertifikate anbieten; jeder Empfänger sieht die Anforderung, und der Einzelvertrag trägt das Merkmal GC-unterlegt.
falseUnternehmenskennungen aktiver Counterparties in der Verkäuferrolle. Ihre Angebote sind verbindlich und annehmbar — ohne verbindliche Empfänger führt eine Anfrage zu keinem Abschluss. Die Angabe kann entfallen, wenn indicative_recipients mindestens einen Empfänger nennt.
Unternehmenskennungen von Unternehmen in der Verkäuferrolle, die den Empfang indikativer Anfragen aktiviert haben und noch keine Counterparties sind. Ihre Angebote sind indikativ und nicht annehmbar. Die Angabe kann entfallen.
Länge des Angebotsfensters in Minuten, gezählt ab der Veröffentlichung — 2 bis 24 Stunden in Schritten von 2 Stunden
480120 | 240 | 360 | 480 | 600 | 720 | 840 | 960 | 1080 | 1200 | 1320 | 1440Geplante Veröffentlichungszeit (ISO 8601, UTC). Bleibt sie weg, wird sofort veröffentlicht — die Anfrage ist mit dem Anlegen aktiv. Die Empfänger werden in jedem Fall mit dem Anlegen benachrichtigt.
date-timeResponse Body
curl -X POST "https://api.otark.com/v1/rfqs" \ -H "Content-Type: application/json" \ -d '{ "energy_source": "solar", "delivery_period": "2026-Q3", "nominal_power": 10 }'{
"id": "rfq_h7t2m9c4",
"status": "active",
"energy_source": "solar",
"reference_index": "ENWEX Solar DE",
"delivery_period": {
"id": "2026-Q3",
"type": "quarter",
"display_name": "Q3 2026",
"delivery_start": "2026-07-01",
"delivery_end": "2026-09-30"
},
"nominal_power": 10,
"max_nominal_power_deviation": 10,
"granular_certificates": true,
"estimated_delivery_volume": 4300,
"quoting_window_minutes": 480,
"publication": "2026-05-12T07:00:00Z",
"expires_at": "2026-05-12T15:00:00Z",
"recipients": [
{
"company_id": "cmp_7d3f9k2a",
"company_name": "Solar Nord",
"type": "binding",
"status": "quoted",
"decline_reason": null
}
],
"accepted_quote_id": null,
"contract_number": null,
"created_at": "2026-05-12T07:00:00Z"
}{
"type": "https://api.otark.com/errors/validation",
"title": "Validierung fehlgeschlagen",
"status": 400,
"instance": "/v1/rfqs",
"errors": [
{
"field": "nominal_power",
"code": "value_too_small",
"message": "Nominal power must be at least 1 MW"
}
]
}{
"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: rfq:write. Please create a new API key with the required scopes."
}