Erste Schritte — in 10 Minuten zum ersten Strompreis

Von null zum ersten Strompreis in ~10 Minuten. Loxone-Nutzer: danach direkt zum Loxone Überblick. Alle anderen: gleiche REST-API per cURL, Python oder Home Assistant. Community: 120 Anfragen/Tag, kostenlos, keine Kreditkarte.

Diese Anleitung ist für Einsteiger. Am Ende haben Sie:

1. ein Konto 2. einen API-Key 3. eine echte Antwort mit Stundenpreisen

Sie brauchen nur einen Browser und idealerweise ein Terminal (oder die Code-Beispiele im Portal).

Was passiert hier eigentlich?

Ihr Programm (oder Testaufruf) fragt unseren Server:

„Wie sieht der österreichische Spotpreis in den nächsten Stunden aus?“

Der Server antwortet mit einer Liste: Stunde → Preis in Cent pro kWh (ct/kWh).

Beispiel aus dem Alltag: Sie öffnen um 10:00 die App und sehen: „Jetzt 9,2 ct/kWh, heute Nacht 3,1 ct/kWh.“ Genau solche Zahlen liefert die Forecast-API.

Schritt für Schritt

1) Konto anlegen

Öffnen Sie Registrieren, E-Mail + Passwort eingeben, absenden.

2) E-Mail bestätigen

Klicken Sie den Link in der Mail. Danach sind Sie im Community-Tarif aktiv (ohne Kreditkarte): längerer Preis-Horizont und Entscheidungs-APIs.

3) API-Key kopieren

Im Portal finden Sie Ihren Key im Format sf_live_….

Speichern Sie ihn wie ein Passwort
Zeigen Sie ihn nicht öffentlich
In dieser Doku steht immer nur der Platzhalter sf_live_YOUR_KEY

4) Ersten Abruf senden

Der Key gehört nur in den Header X-API-Key — nicht in die Adresszeile der URL.


curl https://api.spotpriceapi.com/v1/forecast \
  -H "X-API-Key: sf_live_YOUR_KEY"

Python (stdlib, ohne Extra-Pakete):


import urllib.request
req = urllib.request.Request(
    "https://api.spotpriceapi.com/v1/forecast",
    headers={"X-API-Key": "sf_live_YOUR_KEY"},
)
print(urllib.request.urlopen(req, timeout=30).read().decode())

Loxone: Key nur im Virtual-Output-Header — siehe Loxone Überblick, nicht in PicoC einfügen.

5) Antwort verstehen (ganz grob)

Die Antwort ist JSON (strukturierter Text). Wichtig zuerst:

Feld	Bedeutung in einfachen Worten
`access`	Welcher Tarif gilt für Ihren Key?
`forecast_status`	Hat die Preisreihe geklappt? (`ok` = ja)
`forecast`	Liste der Stunden mit Preisen
`forecast[].price_ct_kwh`	Preis in Cent pro Kilowattstunde
`forecast[].start`	Beginn der Stunde
`forecast[].dump_risk_pct`	Immer vorhanden, 0…100 — Dump-Risiko in Prozent; `0` wenn kein Risiko
`forecast[].dump_scenario_ct_kwh`	Immer nutzbar: Dump-Preis wenn pct > 0, sonst Punktpreis — Clients brauchen keinen null-Check


{
  "forecast_status": "ok",
  "access": { "tier": "community", "label": "Community" },
  "forecast": [
    {
      "start": "2026-08-01T07:00:00+02:00",
      "price_ct_kwh": 8.42
    }
  ]
}

Lesen: Am 1.8. um 7:00 Uhr lokal kostet die Stunde voraussichtlich 8,42 ct/kWh.

Ohne Konto testen (sehr eingeschränkt)


curl https://api.spotpriceapi.com/v1/forecast

Das ist der Basic-Modus: kürzerer Horizont, keine Decision-/Hours-Funktionen. Zum Spielen ok — für Loxone/Speicher brauchen Sie einen persönlichen Key.

Häufige Anfängerfehler

Fehler	Richtig
Key in der URL `?key=…`	Nur Header `X-API-Key`
„HTTP 200 heißt immer alles gut“	Bei Forecast/Decision oft trotzdem 200 — Status steht im JSON (`forecast_status`, `access`, …)
Erwarten von 7 Tagen ohne Community-Key	Längerer Horizont braucht Community/Professional/OEM

Was als Nächstes?

Hours Demand — EMS-Stundenbedarf (Leitprodukt); Marketing Hours
PV Forecast — 7-Tage-Ertrag; Marketing PV Forecast
[Schnellstart](/code-samples?scenario=hours) — Samples mit Ihrem Key
Authentifizierung — Tiers und sicherer Key-Umgang
Forecast API — Preisliste
Loxone Überblick — wenn Sie einen Miniserver haben

Mit SpotpriceAPI starten

Community registrieren oder Code-Beispiele mit Ihrem persönlichen Key.

Live API-Status