api.warp-charger.com

Öffentliche API für WARP Charger und Energy Manager zum Abruf von Day-Ahead-Strompreisen, Temperatur- und PV-Ertragsvorhersagen.

Endpunkte

GET /v1/day_ahead_prices/<country>/<resolution>

Gibt Day-Ahead-Strompreise von der ENTSO-E Transparency Platform zurück.

Parameter	Werte	Beschreibung
country	`de`, `lu`, `at`	Gebotszone (DE/LU teilen sich eine Zone)
resolution	`15min`, `60min`	Zeitliche Auflösung der Preise

Beispiel

curl https://api.warp-charger.com/v1/day_ahead_prices/de/15min

Antwort

{
  "first_date": 1771455600,    // Start-Zeitstempel (UTC)
  "prices": [8780, 8330, ...], // Centicent/MWh (1/100 ct/kWh = Preis * 0,00001 EUR/kWh)
  "next_date": 1771590600      // Wann erneut abfragen (UTC)
}

Preise sind ganzzahlige Werte in Centicent pro MWh. Umrechnung in EUR/kWh: mit 0,00001 multiplizieren. Daten umfassen typischerweise heute und morgen (verfügbar nach ca. 13:00 MEZ).

GET /v1/temperatures/<lat>/<lon>

Gibt stündliche Temperaturvorhersagen für heute und morgen zurück (DWD ICON-Modell via Open-Meteo). Daten sind auf die lokale Mitternacht der aus den Koordinaten abgeleiteten Zeitzone ausgerichtet.

Parameter	Bereich	Beschreibung
lat	`-90` to `90`	Breitengrad (Dezimalgrad)
lon	`-180` to `180`	Längengrad (Dezimalgrad)

Beispiel

curl https://api.warp-charger.com/v1/temperatures/51.93/8.63

Antwort

{
  "first_date": 1771369200,         // UTC-Zeitstempel der lokalen Mitternacht heute
  "temperatures": [82, 79, 76, ...] // 47–49 Werte in Zehntel °C
}

Temperaturen sind ganzzahlige Werte in Zehntel Grad Celsius (z.B. 123 = 12,3 °C). Das temperatures-Array enthält 47–49 Werte (einer pro Stunde, für heute + morgen). Die Array-Größe variiert durch Zeitumstellungen: 47 (Sommerzeit), 48 (normal) oder 49 (Winterzeit).

GET /v1/solar_forecast/<lat>/<lon>/<dec>/<az>/<wp> Test

Hinweis: Dieser Endpunkt befindet sich derzeit nur im Testbetrieb und kann sich ändern oder ausfallen. Noch nicht für den produktiven Einsatz verwenden.

Gibt eine stündliche PV-Ertragsprognose für heute und morgen zurück. Daten sind auf die lokale Mitternacht der aus den Koordinaten abgeleiteten Zeitzone ausgerichtet.

Parameter	Bereich	Beschreibung
lat	`-90` to `90`	Breitengrad (Dezimalgrad)
lon	`-180` to `180`	Längengrad (Dezimalgrad)
dec	`0` to `90`	Modulneigung (0° = waagerecht, 90° = senkrecht)
az	`-180` to `180`	Ausrichtung (0° = Süd, -90° = Ost, 90° = West, ±180° = Nord)
wp	`>0`	Installierte Spitzenleistung in Watt-Peak

Beispiel

curl https://api.warp-charger.com/v1/solar_forecast/51.93/8.63/30/0/9750

Antwort

{
  "first_date": 1771369200,    // UTC-Zeitstempel der lokalen Mitternacht heute
  "resolution": 60,            // Auflösung in Minuten (immer 60)
  "forecast": [0, 0, 145, ...] // Wh pro Stunde (heute + morgen)
}

Der Ertrag wird ganzzahlig in Wattstunden pro Stunde zurückgegeben. Das forecast-Array enthält bis zu 48 Werte (einer pro Stunde, für heute + morgen). Ein zusätzlicher, forecast.solar-kompatibler Endpunkt /estimate/<lat>/<lon>/<dec>/<az>/<kWp> steht für bestehende Firmware bereit.

Fehler

Alle Fehler werden als JSON mit einem error-Feld und einem passenden HTTP-Statuscode zurückgegeben.

{"error": "Data not found"}        // 404
{"error": "Country not supported"} // 400