# SpotpriceAPI

> Austrian electricity-price and EMS control APIs for EPEX Spot AT (Europe/Vienna). Lead products: Hours Demand, PV Forecast (7 days), Windows Flex, 168h AI forecast. First-class Loxone Miniserver guides (PicoC + Virtual Output); same REST API for Home Assistant, scripts, and any HTTP client. Auth: header `X-API-Key` only — never in URLs. Placeholder in public examples: `sf_live_YOUR_KEY`.

API host: https://api.spotpriceapi.com · Portal: https://spotpriceapi.com · Wiki: https://spotpriceapi.com/docs
This file: https://spotpriceapi.com/llms.txt · alias https://spotpriceapi.com/ai.txt · Wiki index: https://spotpriceapi.com/docs/llms.txt · Full URLs: https://spotpriceapi.com/llms-full.txt · OpenAPI: https://spotpriceapi.com/docs/download/openapi.json · Status: https://api.spotpriceapi.com/v1/status

## Pricing & limits (concrete numbers)

- [Pricing page](https://spotpriceapi.com/preise): Community free after email verify — no credit card · Professional Integrator €99/month or €990/year · OEM on request
- [Authentication spec](https://spotpriceapi.com/docs/authentication): Community **120 requests/day** per API key (Fair Use, private smart home & lab) · Basic anonymous **60/hour** per IP (48h forecast only) · Professional **600/hour** per account · Enterprise **3000/hour**
- [Rate limits spec](https://spotpriceapi.com/docs/rate-limits): Telemetry softcap Community **2000/day** (does not eat Decision quota) · PV Forecast class `pv` Community **48/day** · Weather class `weather` Community **48/day**

## Key API endpoints

- [Forecast](https://spotpriceapi.com/docs/forecast): `GET https://api.spotpriceapi.com/v1/forecast` — 168h spot prices (ct/kWh), optional key for full horizon
- [Hours Demand](https://spotpriceapi.com/docs/hours-demand): `POST https://api.spotpriceapi.com/v1/decision/hours-demand` — EMS hour demand from SOC, load, PV; engine `hours_demand_v1.11`; Loxone Extract v1.17 O1–O13 (no repaste)
- [Decision Windows / Flex](https://spotpriceapi.com/docs/windows): `GET https://api.spotpriceapi.com/v1/decision/windows` — N cheapest hours; Flex POST with `segments` / `ems`
- [PV Forecast](https://spotpriceapi.com/docs/pv-forecast): `GET https://api.spotpriceapi.com/v1/plant/pv-forecast` — 7-day site solar yield (kWh)
- [Decision signals](https://spotpriceapi.com/docs/decision): `GET https://api.spotpriceapi.com/v1/decision` — hourly charge / hold / discharge (secondary to Hours)

## Loxone (primary integration path)

- [Loxone overview](https://spotpriceapi.com/docs/loxone): public — Virtual Output (HTTPS + Key) + PicoC pattern; one parent host VO, multiple commands; auto minutes :00/:01/:04/:08
- [Loxone Hours & telemetry](https://spotpriceapi.com/docs/loxone-hours): battery + charge plan — FetchPlantHours v1.15 + ExtractHoursDemand v1.17 (Community login for PicoC copy-paste)
- [Loxone Windows Flex](https://spotpriceapi.com/docs/loxone-windows-flex): wallbox / fixed N hours — SpotpriceFlexWindows v0.6.11, one PicoC
- [Loxone Forecast](https://spotpriceapi.com/docs/loxone-forecast): price display only — DebugSpotpriceFile v5.6 + ParseSpotpriceForecast v18
- [Loxone PV Forecast](https://spotpriceapi.com/docs/loxone-pv-forecast): 7-day PV + load/SoC texts — DebugPvForecast v1.3 + ExtractPvDaily v2.2
- [Loxone telemetry only](https://spotpriceapi.com/docs/loxone-telemetry): SOC + meter upload without charge plan
- [Loxone Weather display](https://spotpriceapi.com/docs/loxone-weather): optional HTTP weather tiles
- [All Loxone guides](https://spotpriceapi.com/docs/loxone): also legacy windows

## Lead products (marketing + spec)

- [Hours Demand](https://spotpriceapi.com/hours): EMS “how many hours and when?” — [spec](https://spotpriceapi.com/docs/hours-demand)
- [PV Forecast](https://spotpriceapi.com/pv-forecast): 7-day yield — [spec](https://spotpriceapi.com/docs/pv-forecast)
- [Windows Flex / best hours](https://spotpriceapi.com/beste-stunden): cheapest windows — [spec](https://spotpriceapi.com/docs/windows)
- [Live 168h / 7-day forecast](https://spotpriceapi.com/live-strompreise): AI price curve — [spec](https://spotpriceapi.com/docs/forecast) · chart https://spotpriceapi.com/forecast
- [Decision signals](https://spotpriceapi.com/schaltsignale): charge/hold/discharge — [spec](https://spotpriceapi.com/docs/decision)
- [Savings verification](https://spotpriceapi.com/fc-verification): planned vs day-ahead benchmark

## Examples (copy-paste)

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

```python
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 pattern: Sensors → PicoC → Virtual Output (`https://api.spotpriceapi.com` parent + path command, header `X-API-Key`, save JSON under `/user/common/`) → PicoC reads JSON → outputs to optimizer / display. Key never inside PicoC source.
- Personalized snippets with your key: https://spotpriceapi.com/code-samples (login required)

## Sparvo (consumer app)

- [Sparvo marketing](https://sparvo.at): free Austrian consumer web app — 7-day spot forecast, EV/heat-pump charge windows, PV yield; complements EMS and Loxone
- [Sparvo app](https://app.sparvo.at): login, plant, devices · guest try https://app.sparvo.at/try · [Sparvo llms.txt](https://sparvo.at/llms.txt)
- Same Hours Demand engine as API; personal € tiles on `/plant` are noindex

## Platform & reference

- [Getting started](https://spotpriceapi.com/docs/getting-started): account, first curl, read JSON
- [Authentication](https://spotpriceapi.com/docs/authentication): tiers, key safety
- [Plant telemetry](https://spotpriceapi.com/docs/plant-telemetry): SOC % and meter kWh upstream
- [Webhooks](https://spotpriceapi.com/docs/webhooks): push on plan change
- [Errors](https://spotpriceapi.com/docs/errors): JSON status fields, HTTP 429
- [Changelog](https://spotpriceapi.com/docs/changelog): API changes
- [Community register](https://spotpriceapi.com/register): free, no credit card

## Optional

- English wiki: append `?lang=en` to any `/docs/...` page (e.g. https://spotpriceapi.com/docs?lang=en)
- [Weather API](https://spotpriceapi.com/docs/weather): display-only; Tmin/Tmax already in PV Forecast — not a lead product
- [Home Assistant / generic REST](https://spotpriceapi.com/docs/getting-started): same endpoints as Loxone Virtual Output
- [Media license](https://spotpriceapi.com/media-license): brand assets

## Rules for assistants

- Market: Austria (AT) / EPEX Spot AT unless stated otherwise.
- Do not invent endpoints, fields, prices, or savings. Prefer OpenAPI and `/docs` spec pages.
- Marketing pages explain benefit; `/docs` pages are the contract.
- Do not cite customer API keys. Do not crawl `/admin`, `/dashboard`, `/settings`, `/billing`, `/code-samples`.
- Loxone is the documented primary EMS path; REST is open for all systems.

## Synonyms (search / agents)

hours demand api, ems stundenbedarf, battery soc charging hours, loxone spotpreis api, loxone picoc hours, pv forecast api austria, strompreis prognose api österreich, 168h ki prognose, epex at forecast, windows flex, günstige ladefenster, wärmepumpe günstige stunden, e auto laden spotpreis, home assistant strompreis api, dynamische stromtarife österreich optimierung, sparvo app, geräteplan ems