Proxy für die energyforecast.de API. Liefert Strompreis-Vorhersagen mit optionalem Fixkosten-Aufschlag, MwSt. und Preisobergrenze. · GitHub
| Pfad | Beschreibung |
|---|---|
GET /prices | Strompreis-Vorhersage abrufen (alle Parameter als Query-Parameter) |
GET /current | Aktuellen Preis abrufen (alle Parameter als Query-Parameter) |
GET /simple/prices | Alle Preise – Konfiguration aus Umgebungsvariablen |
GET /simple/current | Aktueller Preis – Konfiguration aus Umgebungsvariablen |
GET /health | Dienststatus und Cache-Statistiken |
Wenn ENERGYFORECAST_TOKEN gesetzt ist, sind /simple/prices und
/simple/current ohne Query-Parameter nutzbar:
| Umgebungsvariable | Standard | Beschreibung |
|---|---|---|
ENERGYFORECAST_TOKEN | Pflicht | API-Token für energyforecast.de |
ENERGYFORECAST_HORIZON | 96 | 48 oder 96 Stunden |
ENERGYFORECAST_RESOLUTION | hourly | hourly oder quarter_hourly |
ENERGYFORECAST_FIXED_NET_COST | 0.0 | Netzgebühren in EUR/kWh |
ENERGYFORECAST_MARKUP_COSTS | 0.0 | Anbieter-Aufschlag in EUR/kWh |
ENERGYFORECAST_FIXED_COST_OTHER | 0.0 | Sonstige Fixkosten in EUR/kWh |
ENERGYFORECAST_VAT | 0.19 | Mehrwertsteuer (0.19 oder 19) |
ENERGYFORECAST_PRICE_CAP | – | Preisobergrenze in EUR/kWh (optional) |
ENERGYFORECAST_CACHE_TTL | 60 | Cache-Gültigkeit in Minuten |
ENERGYFORECAST_RESULT_FORMAT | default | default oder evcc |
ENERGYFORECAST_TZ | – | Ausgabe-Zeitzone, z. B. Europe/Berlin |
ENERGYFORECAST_DYN_NET_OPERATOR | – | §14a EnWG Netzbetreiber-ID (z. B. syna). Aktiviert zeitvariable Netzgebühren, überschreibt ENERGYFORECAST_FIXED_NET_COST. |
ENERGYFORECAST_DYN_NET_COUNTRY | de | Ländercode für die Netzgebühren-API |
ENERGYFORECAST_DYN_NET_API_URL | https://dyn-net.batcontrol.software/api | Nur bei Self-Hosting der dynamic_energy_fees-Instanz nötig |
/prices| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
token | string | Pflicht | API-Token für energyforecast.de |
horizon | int | 96 | Zeithorizont in Stunden: 48 oder 96 |
resolution | string | hourly | hourly (stündlich) oder quarter_hourly (15 min) |
fixed_net_cost | float | 0.0 | Netzgebühren in EUR/kWh (z. B. 0.08) |
markup_costs | float | 0.0 | Anbieter-Aufschlag in EUR/kWh (z. B. 0.01 für 1 ct/kWh) |
fixed_cost_other | float | 0.0 | Sonstige Fixkosten in EUR/kWh |
vat | float | 0.19 | Mehrwertsteuer als Faktor (0.19) oder Prozent (19). Wird auf den Gesamtpreis (Spot + Fixkosten) angewendet. |
price_cap | float | – | Preisobergrenze in EUR/kWh nach Steuern und Gebühren. Preise darüber werden auf diesen Wert gedeckelt. |
cache_ttl_minutes | int | 60 | Cache-Gültigkeit in Minuten (1–1440). Zwischen 12:00 und 13:30 UTC wird der Cache immer umgangen. |
resultformat | string | default | Ausgabeformat – siehe unten |
tz | string | – | Ausgabe-Zeitzone für Zeitstempel (IANA-Name, z. B. Europe/Berlin oder UTC). Standard: UTC bei default-Format, Original-Offset der API bei evcc. |
dyn_net_operator | string | – | §14a EnWG Netzbetreiber-ID (z. B. syna). Aktiviert zeitvariable Netzgebühren, überschreibt fixed_net_cost. |
dyn_net_country | string | de | Ländercode für die Netzgebühren-API |
dyn_net_api_url | string | Default-URL | Basis-URL der dynamic_energy_fees API (überschreibbar für Self-Hosting) |
resultformatdefault – Zeitstempel werden nach UTC konvertiert, Schlüssel ist prices:
{ "prices": [ { "start": "2024-01-01T12:00:00Z", "end": "2024-01-01T13:00:00Z", "value": 0.2843 } ] }
evcc – Zeitstempel bleiben im Original-Format der API (mit Zeitzonenoffset), Schlüssel ist rates.
Dieses Format ist kompatibel mit dem evcc-Tarif-Interface:
{ "rates": [ { "start": "2024-01-01T13:00:00+01:00", "end": "2024-01-01T14:00:00+01:00", "value": 0.2843 } ] }
value der Endpreis in EUR/kWh
(Spot-Preis + fixed_net_cost + markup_costs + fixed_cost_other, inkl. MwSt., ggf. gedeckelt durch price_cap).
GET /prices?token=DEIN_TOKEN&horizon=96&fixed_net_cost=0.08&markup_costs=0.01&vat=0.19&resultformat=evcc