1-Click PPA API

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

Als Markdown anzeigen

Freischaltung erforderlich

Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den Support.
POST
/v1/rfqs
X-Api-Key<token>

In: header

energy_sourcestring

Energieträger — bestimmt den Referenzindex (ENWEX Solar DE oder ENWEX Wind DE)

Value in"solar" | "wind"
delivery_periodstring

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.

nominal_powernumber

Vertragsleistung in MW (mindestens 1, Schrittweite 0,01)

Range1 <= value
max_nominal_power_deviation?number

Zulä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.

Default0
Range0 <= value <= 100
granular_certificates?boolean

Lieferung 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.

Defaultfalse
binding_recipients?array<string>

Unternehmenskennungen 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.

indicative_recipients?array<string>

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.

quoting_window_minutes?integer

Länge des Angebotsfensters in Minuten, gezählt ab der Veröffentlichung — 2 bis 24 Stunden in Schritten von 2 Stunden

Default480
Value in120 | 240 | 360 | 480 | 600 | 720 | 840 | 960 | 1080 | 1200 | 1320 | 1440
publication?string

Geplante 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.

Formatdate-time

Response 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."
}