SpotpriceAPI — how to read this documentation

Austrian electricity-price and EMS APIs (EPEX Spot AT). Loxone Miniserver is our primary integration path — Virtual Output + PicoC with copy-paste guides. The same REST API is open for Home Assistant, Python, cURL, and any HTTP client. Community tier is free: 120 requests/day per key after registration — no credit card.

In one sentence: SpotpriceAPI delivers Hours Demand, PV Forecast (7 days), Windows Flex, and the 168h AI forecast — plus this wiki and the Sparvo consumer app.

Quick start (3 steps)

1. Register (free Community) → copy API key sf_live_… 2. Send your first request — key only in header X-API-Key:


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

3. Loxone? → Loxone overview · Script/HA? → Getting started

Pricing & limits (numbers)

Tier	Cost	Quota	Horizon / features
Basic	no account	60/h per IP	48h forecast, no Decision/Hours
Community	free	120/day per key	168h, Decision, Windows, Hours, telemetry
Professional	€99/mo · €990/yr	600/h per account	Community features + higher quota
OEM	on request	3000/h	partner / white-label

Details: Authentication · Rate limits · Pricing

Key API endpoints

Endpoint	Purpose
`GET /v1/forecast`	168h hourly prices (ct/kWh)
`POST /v1/decision/hours-demand`	EMS hour demand from SOC/load/PV
`GET /v1/decision/windows`	N cheapest hours / Flex slots
`GET /v1/plant/pv-forecast`	7-day site PV yield (kWh)
`GET /v1/decision`	charge / hold / discharge (secondary)

OpenAPI: /docs/download/openapi.json

Loxone — our primary EMS path

Situation	Guide
Battery + charge plan	Hours & telemetry ← recommended
Wallbox, fixed N hours	Flex Windows
Display prices only	Loxone Forecast
PV daily values + texts	Loxone PV Forecast
Upload SOC/meter only	Telemetry only

Open API: The same endpoints work in any HTTP client — Loxone is simply the best-documented path.

What is a spot price?

Think of electricity price like a petrol-station price that changes every hour — often cheap at night, often expensive in the evening. SpotpriceAPI helps shift battery, wallbox, or heat-pump load to cheap hours.

Which page do I need?

Getting started

Page	In plain words
Getting started	Account, key, first price, Python example
Authentication	Safe key usage, tiers

Lead products

Page	Everyday example
Hours Demand	Battery at 30 % — how many charge hours today?
PV Forecast	Is tomorrow’s sun enough for the EV?
Windows Flex	The 4 cheapest hours this week
Forecast	Hour by hour: what does power cost?
Decision	Traffic light: charge now or wait?

Plant & notifications

Page	In plain words
Plant telemetry	Send SOC % and meter regularly
Webhooks	Push instead of constant polling
Weather	Display weather (secondary; Tmin/Tmax in PV)

Reference

Errors · Rate limits · Changelog · Downloads

How the pieces fit


1) Hours Demand → “for my battery: how many hours + when?”
2) PV Forecast  → 7-day yield kWh
3) Windows Flex → N cheapest hours / segments
4) Forecast     → 168h price list
5) Telemetry    → SOC/meter for better Hours answers
6) Decision     → traffic-light signals (secondary)

Code examples

Public (placeholder key): Getting started
Personalized with your key: Code samples in the portal (login)
Loxone PicoC: in Loxone guides after login

For AI systems

/llms.txt — short overview incl. pricing, endpoints, Loxone, snippets
/docs/llms.txt — wiki-scoped agent file
/llms-full.txt — full URL list
OpenAPI /docs/download/openapi.json

At the bottom of every page: Previous / Next to browse in order.

Start with SpotpriceAPI

Live API status