# 1-Click PPA API (https://docs.otark.com/de/developer/one-click-ppa-api)

<Callout type="warn" title="Freischaltung erforderlich">
  Diese API muss für Ihr Konto explizit freigeschaltet werden. Wenden Sie sich dazu an den [Support](https://docs.otark.com/de/support).
</Callout>

Die 1-Click PPA API bildet den Weg von der [Anfrage](https://docs.otark.com/de/one-click-ppa/rfq) über das [Angebot](https://docs.otark.com/de/one-click-ppa/quotes) zur [Annahme](https://docs.otark.com/de/one-click-ppa/acceptance) ab und stellt die Daten der laufenden Lieferung bereit. Der Anfrage-Teil richtet sich an die Händler eines Unternehmens mit aktiver Käuferrolle: Sie erstellen Anfragen an ihre Counterparties, sehen die eingehenden Angebote und nehmen an — die Annahme erzeugt den [Einzelvertrag](https://docs.otark.com/de/one-click-ppa/individual-contract). Einzelverträge, Lieferdaten und die REMIT-Einstellung stehen Käufern und Verkäufern offen.

## Basis-URL

```
https://api.otark.com/v1
```

Alle Aufrufe müssen HTTPS verwenden. Antworten werden im JSON-Format zurückgegeben.

## Authentifizierung

Alle Aufrufe müssen den `X-Api-Key`-Header enthalten:

```bash
curl -X GET "https://api.otark.com/v1/contracts" \
-H "X-Api-Key: IHR_API_KEY"
```

Wie die Authentifizierung plattformweit funktioniert und wo die Schlüssel der übrigen APIs entstehen, steht unter [Authentifizierung](https://docs.otark.com/de/developer/authentication).

API-Schlüssel erstellen Sie in den Kontoeinstellungen auf app.otark.com. Jeder Schlüssel trägt Scopes — `rfq:read`, `rfq:write`, `contracts:read`, `deliveries:read` —, und jede Operation nennt die Scopes, die sie verlangt. Bewahren Sie Ihren Schlüssel sicher auf.

## Konventionen

| Konvention        | Regel                                                                                                                                                                                                                           |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Paginierung       | Listen nehmen `limit` (1–100, Vorgabe 10) und einen Cursor `after` entgegen; die Antwort führt `pagination` mit `has_more` und `next_cursor`                                                                                    |
| Zeitstempel       | ISO 8601 in UTC (`2026-07-15T11:00:00Z`); Liefertage als `YYYY-MM-DD`                                                                                                                                                           |
| Stunden           | 1–24 nach EPEX-Konvention — Stunde 14 ist 13:00–14:00 Europe/Berlin; am 25-Stunden-Tag der Winterzeit-Umstellung tritt Stunde 3 zweimal auf und wird über `hour_suffix` als 3A/3B unterschieden, am 23-Stunden-Tag entfällt sie |
| Mengen und Preise | Mengen in MWh (drei Nachkommastellen), Preise in EUR/MWh (zwei Nachkommastellen)                                                                                                                                                |
| Fehler            | `application/problem+json` nach RFC 9457, mit Feldfehlern bei Validierungsfehlern                                                                                                                                               |
| Ratenbegrenzung   | **300 Anfragen je 60-Sekunden-Fenster**, plattformweit gleich; die Antwort führt `X-RateLimit-Limit`, `-Remaining` und `-Reset` mit, bei Überschreitung `429 Too Many Requests`                                                 |

## Ressourcen

| Ressource         | Zweck                                                                                 | Rolle                |
| ----------------- | ------------------------------------------------------------------------------------- | -------------------- |
| Counterparties    | aktive Verbindungen und ihr Verbindungsstatus                                         | Käufer und Verkäufer |
| Anfragen (RFQs)   | erstellen — auf Wunsch mit GC-Anforderung —, einsehen, abbrechen                      | Käufer               |
| Angebote          | je Anfrage einsehen und annehmen; die Annahme erzeugt den Einzelvertrag               | Käufer               |
| Einzelverträge    | Liste und Details, mit PDF-Dokument und Merkmal GC-unterlegt                          | beide                |
| Lieferdaten       | Indexwerte und gelieferte Mengen je Stunde und Monat                                  | beide                |
| REMIT-Einstellung | Meldemodus einsehen und einmalig wählen, einen späteren Wechsel nimmt der Support vor | beide                |

## Vom Klick zum Vertrag

* Eine Anfrage geht nie „an den Markt", sondern an eine **explizite Empfängerliste**: Verbindliche Empfänger sind aktive Counterparties mit Verkäuferrolle, indikative Empfänger brauchen keine Verbindung ([Anfrage](https://docs.otark.com/de/one-click-ppa/rfq)).
* **Indikative Angebote sind nicht annehmbar** — die API weist die Annahme eines indikativen Angebots mit `409` ab; der Weg zum Geschäft führt über eine [Verbindung](https://docs.otark.com/de/one-click-ppa/counterparties) und eine neue, verbindliche Anfrage ([Angebot](https://docs.otark.com/de/one-click-ppa/quotes)).
* Die **Annahme** erzeugt den Einzelvertrag in einer untrennbaren Transaktion; das Merkmal GC-unterlegt kommt aus der Anfrage ([Annahme](https://docs.otark.com/de/one-click-ppa/acceptance), [Granulare Zertifikate bei 1-Click PPA](https://docs.otark.com/de/one-click-ppa/granular-certificates)).
* **Geld fließt direkt zwischen den Parteien**: Der Verkäufer rechnet monatlich ab, der Käufer zahlt an ihn — OES liefert mit den Lieferdaten nur die Datengrundlage ([Rechnungsstellung](https://docs.otark.com/de/one-click-ppa/invoicing)).
* **REMIT**: Standard ist die Meldung durch OES; die Abweichung vereinbaren die Parteien in einer Anpassungsvereinbarung, der Meldemodus in der API ist ihre technische Umsetzung und gilt je Teilnehmer für alle Verbindungen und Green SPOT ([REMIT-Meldung](https://docs.otark.com/de/one-click-ppa/remit-reporting)).

## Support

Bei Fragen oder für weitere Unterstützung erreichen Sie uns über den [Support](https://docs.otark.com/de/support).
