SpotWave API

Die Preise auf SpotWave stammen aus einer kleinen JSON-API, über die sich Daten nur abrufen lassen. Sie dürfen sie für eigene Projekte, Dashboards und Hausautomation nutzen, im Rahmen der Nutzungsbedingungen unten.

Grundlagen

Endpunkte

GET /meta/markets

Alle unterstützten Märkte (Gebotszonen) mit Namen, Währung und festen Monatskosten (inkl. MwSt.), die nie in den Preis pro kWh eingerechnet werden.

curl https://spotwave.eu/api/meta/markets
[
  {
    "code": "NL",
    "name": "Netherlands",
    "currency": "EUR",
    "fees": {
      "gridFixedPerMonth": 39.83,
      "energyTaxCreditPerMonth": 52.41,
      "netPerMonth": -12.58,
      "native": { "currency": "EUR", "gridFixedPerMonth": 39.83, "energyTaxCreditPerMonth": 52.41, "netPerMonth": -12.58 }
    }
  },
  …
]

GET /spotprice?country=…&from=…&to=…

Die Zusammensetzung des Gesamtpreises für jede Periode in einem Zeitraum. from und to sind ISO-Zeitstempel (einschließlich); ein Zeitraum über 92 Tage wird auf die letzten 92 Tage gekürzt.

curl "https://spotwave.eu/api/spotprice?country=NL&from=2026-10-20T00:00:00Z&to=2026-10-20T23:59:59Z"
[
  {
    "periodUtc": "2026-10-20T12:00:00Z",
    "country": "NL",
    "spotEurPerKwh": 0.10301,
    "energyTaxEurPerKwh": 0.0916,
    "gridFeeEurPerKwh": 0.0,
    "vatEurPerKwh": 0.0408681,
    "totalEurPerKwh": 0.2354781,
    "native": { "currency": "EUR", "spotPerKwh": 0.10301, "energyTaxPerKwh": 0.0916, "gridFeePerKwh": 0.0, "vatPerKwh": 0.0408681, "totalPerKwh": 0.2354781 }
  },
  …
]

GET /forecast?country=…&from=…&to=…

Dieselben Parameter und dieselbe Antwort wie /spotprice, für den morgigen Tag. Liefert eine leere Liste, bis die Day-Ahead-Preise für morgen veröffentlicht sind, meist gegen 13:00 Uhr.

curl "https://spotwave.eu/api/forecast?country=DE&from=2026-10-21T00:00:00Z&to=2026-10-21T23:59:59Z"

GET /spotprice/current?country=…

Der zuletzt gespeicherte Börsenpreis eines Marktes: nur der reine Börsenpreis, ohne Steuern und Entgelte. hourUtc ist der Beginn der Periode. Liefert 404, wenn für den Markt keine Daten vorliegen.

curl "https://spotwave.eu/api/spotprice/current?country=NL"
{ "id": 3179619, "country": "NL", "hourUtc": "2026-10-20T15:45:00Z", "eurPerKwh": 0.25471 }

GET /spotprice/stats?country=…

Perzentile des Börsenpreises der letzten 30 Tage. Daran misst SpotWave, ob ein Preis günstig oder teuer ist.

curl "https://spotwave.eu/api/spotprice/stats?country=SE3"
{
  "p25": 0.0401, "median": 0.0825, "p75": 0.1208, "avg": 0.0842,
  "native": { "currency": "SEK", "p25": 0.4452, "median": 0.9165, "p75": 1.3411, "avg": 0.9352 }
}

GET /spotprice/context?country=…

Langfristige Vergleichswerte: der gleitende Jahresdurchschnitt des Gesamtpreises, der des Vorjahres und ein typical-Band (niedrig/mittel/hoch je Tagesstunde, UTC) aus derselben Jahreszeit der letzten Jahre. Die Felder sind null, solange zu wenig Historie vorliegt.

curl "https://spotwave.eu/api/spotprice/context?country=NL"
{
  "yearAvg": 0.2409, "lastYearAvg": 0.2219,
  "typical": [ { "i": 0, "low": 0.1694, "mid": 0.2172, "high": 0.2650 }, … ],
  "native": { "currency": "EUR", "yearAvg": 0.2409, "lastYearAvg": 0.2219, "typical": [ … ] }
}

GET /compare

Eine Momentaufnahme aller Märkte: aktueller Gesamt- und Börsenpreis, die bisherige Spanne von heute, Steueranteil, Mehrwertsteuersatz und eine stündliche Sparkline, vom günstigsten Markt an sortiert. Darauf beruht die Seite Märkte.

curl https://spotwave.eu/api/compare
{
  "asOf": "2026-10-20T15:58:49Z",
  "euAvgSpot": 0.1596,
  "zones": [
    {
      "country": "NL", "name": "Netherlands",
      "currentAllIn": 0.4012, "spot": 0.2400, "taxShare": 40.19, "vatRate": 21.0,
      "todayMin": 0.2307, "todayMax": 0.4012, "isNegative": false,
      "sparkline": [0.1701, 0.1681, 0.1722, …],
      "native": { "currency": "EUR", "currentAllIn": 0.4012, "spot": 0.2400, "todayMin": 0.2307, "todayMax": 0.4012, "sparkline": [ … ] }
    },
    …
  ]
}

GET /meta/status

Wann die Daten zuletzt aktualisiert wurden und je Markt, ob die Preise für morgen schon da sind. Hilfreich, um zu entscheiden, wann Sie /forecast abrufen.

curl https://spotwave.eu/api/meta/status
{ "lastUpdated": "2026-10-20T13:05:12Z", "tomorrowPublished": { "NL": true, "DE": true, "SE3": false, … } }

GET /history

Vergangene Preise eines Marktes: Monats- und Jahresdurchschnitte, Rekordtage und -stunden, Stunden unter null und der durchschnittliche Preis je Tagesstunde der letzten 12 Monate. Nur der Börsenpreis, in der Währung des Marktes zum heutigen Kurs.

curl "https://spotwave.eu/api/history?country=NL"

GET /history/month

Ein Monat Tag für Tag: Mittel, Tief und Hoch, Stunden unter null, günstigster und teuerster Tag sowie die Mittelwerte des Vormonats und desselben Monats im Vorjahr.

curl "https://spotwave.eu/api/history/month?country=NL&month=2026-09"

Mit KI-Assistenten nutzen

SpotWave ist auch ein MCP-Server, sodass KI-Assistenten und Agents aktuelle und vergangene Preise selbst abfragen können. Fügen Sie https://spotwave.eu/api/mcp in einem MCP-fähigen Client als entfernten MCP-Server hinzu (Streamable HTTP, ohne Schlüssel). Es gibt vier Tools: list_markets, get_current_price, get_prices (heute, morgen oder ein vergangener Tag) und compare_markets.

curl https://spotwave.eu/api/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Den Preis auf Ihrer Website einbinden

Ein kleines Widget mit dem heutigen Gesamtpreis und Verlauf, mit einem Link zu SpotWave. Den Markt wählen Sie mit market (jeder Code aus /meta/markets), die Sprache mit lang (en, nl, de, da, sv, nb, fi) und das Design mit theme (light oder dark).

<iframe src="https://spotwave.eu/embed?market=NL&lang=de&theme=light"
  width="360" height="300" style="border:0;border-radius:14px"
  title="Strompreis heute" loading="lazy"></iframe>

Faire Nutzung

Quellenangabe

Wenn Sie etwas veröffentlichen, das auf diesen Daten beruht, nennen Sie SpotWave bitte mit einem Link auf spotwave.eu. Die Börsenpreise stammen von der ENTSO-E Transparency Platform; Steuern und Entgelte sind eigene Richtwerte von SpotWave, erläutert auf der Seite Datenquellen.

Home Assistant

Eine Home-Assistant-Integration, die diese API nutzt, ist in Vorbereitung. Bis dahin kann der eingebaute RESTful-Sensor von Home Assistant /spotprice/current direkt auslesen.

Märkte · Ratgeber · API