# SpotpriceAPI Wiki (/docs)

> Public API documentation for SpotpriceAPI — plain language, DE default and EN via `?lang=en`. Optimized for Loxone Miniserver (Virtual Output + PicoC) and open REST for Home Assistant, Python, cURL, and any HTTP client. Contract pages live here; marketing lives on `/hours`, `/pv-forecast`, etc.

Canonical site llms: https://spotpriceapi.com/llms.txt · This file: https://spotpriceapi.com/docs/llms.txt · OpenAPI: https://spotpriceapi.com/docs/download/openapi.json

Community tier: **120 requests/day** per key after free registration (no credit card). Basic anonymous: **60/hour** per IP, 48h forecast. Professional: **600/hour** per account (€99/mo · €990/yr).

## Start here

- [Documentation hub](https://spotpriceapi.com/docs): overview — which page for which job
- [Getting started](https://spotpriceapi.com/docs/getting-started): account, API key, first `curl`, read JSON
- [Authentication](https://spotpriceapi.com/docs/authentication): `X-API-Key` header, tiers, key rotation
- [Rate limits](https://spotpriceapi.com/docs/rate-limits): 120/day Community, telemetry/PV/weather classes
- [Errors](https://spotpriceapi.com/docs/errors): `forecast_status`, HTTP 429, retry

## Lead API specs

- [Hours Demand](https://spotpriceapi.com/docs/hours-demand): `POST /v1/decision/hours-demand` — EMS hour plan from SOC/load/PV
- [PV Forecast](https://spotpriceapi.com/docs/pv-forecast): `GET /v1/plant/pv-forecast` — 7-day kWh yield
- [Decision Windows](https://spotpriceapi.com/docs/windows): `GET /v1/decision/windows` — cheapest hours + Flex segments
- [Forecast](https://spotpriceapi.com/docs/forecast): `GET /v1/forecast` — 168h ct/kWh list
- [Decision](https://spotpriceapi.com/docs/decision): `GET /v1/decision` — charge/hold/discharge signals

## Loxone guides (primary EMS integration)

- [Loxone overview](https://spotpriceapi.com/docs/loxone): public — VO + PicoC, shared host, poll minutes (no PicoC in URL)
- [Hours & telemetry](https://spotpriceapi.com/docs/loxone-hours): battery systems — FetchPlantHours v1.15, Extract v1.17 (login + Community for PicoC)
- [Windows Flex](https://spotpriceapi.com/docs/loxone-windows-flex): wallbox — SpotpriceFlexWindows v0.6.11
- [Forecast display](https://spotpriceapi.com/docs/loxone-forecast): prices in Loxone app
- [PV Forecast display](https://spotpriceapi.com/docs/loxone-pv-forecast): 7-day PV + texts O1–O13
- [Telemetry only](https://spotpriceapi.com/docs/loxone-telemetry): SOC/meter upload without charge plan
- [Legacy windows](https://spotpriceapi.com/docs/loxone-windows): two-PicoC v1 path
- [Weather display](https://spotpriceapi.com/docs/loxone-weather): optional; Tmin/Tmax already in PV

## Plant & platform

- [Plant telemetry](https://spotpriceapi.com/docs/plant-telemetry): POST SOC and meter readings
- [Webhooks](https://spotpriceapi.com/docs/webhooks): callback on forecast/plan updates
- [Weather](https://spotpriceapi.com/docs/weather): display API (secondary)
- [Download / OpenAPI](https://spotpriceapi.com/docs/download): `openapi.json` machine spec
- [Changelog](https://spotpriceapi.com/docs/changelog): breaking and additive changes

## Examples

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

```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: parent Virtual Output `https://api.spotpriceapi.com` + command paths; header `X-API-Key`; JSON to `/user/common/`; PicoC reads file — never embed key in PicoC.

## Optional

- English mirror: append `?lang=en` to any `/docs/...` URL
- [Code samples portal](https://spotpriceapi.com/code-samples): logged-in snippets with real key
- [Sparvo consumer app](https://sparvo.at/llms.txt): same engine, end-user UI

## Rules for assistants

- Prefer these `/docs` pages over marketing copy for field names and semantics.
- Loxone detail PicoC blocks require Community login in browser — overview `/docs/loxone` is public.
- Do not invent API fields or prices.