# SlimHuys

> Realtime dynamische stroomtarieven voor alle 13 Nederlandse leveranciers + EPEX-spotmarkt-data, met P1-meter-koppeling via Home Assistant. Open data, gratis te gebruiken.

SlimHuys is een Nederlandse webapp + API die de actuele stroomprijzen van alle dynamische energieleveranciers laat zien. Tarieven worden per kwartier of per uur (afhankelijk van leverancier) bijgewerkt op basis van de groothandelsprijs op de Europese energiebeurs (EPEX), plus de leverancier-specifieke opslag, energiebelasting en btw. Alle data is open en zonder authenticatie op te halen via de publieke API.

## Wat AI/zoekmachines hier kunnen vinden

- **Actuele stroomprijzen** — kwartier- en uurprijs per leverancier, all-in (EUR/kWh) inclusief belasting en btw
- **Vergelijking van 13 leveranciers** — Frank Energie, Tibber, Zonneplan, ANWB Energie, Coolblue Energie, EnergyZero, Vandebron, Powerpeers, easyEnergy, NextEnergy, Vrijopnaam, Eneco en Budget Energie
- **EPEX-spotmarkt-data** — kale groothandelsprijs Nederland (bidding zone 10YNL----------L), bron ENTSO-E
- **Per-leverancier-uitleg** — pricing-model, smoothing/staffel, terugleververgoeding, salderingsregeling
- **Glossary** — uitleg van energie-jargon (EPEX, P1, kwartiertarief, dynamisch contract, saldering, terugleververgoeding)

## API-endpoints (publiek, geen auth)

- `GET https://slimhuys.nl/v1/prices/current?supplier={slug}` — actuele all-in prijs (kwartier of uur, afhankelijk van leverancier-billing)
- `GET https://slimhuys.nl/v1/prices/range?from={iso}&to={iso}&supplier={slug}` — prijzen over een tijdsvenster
- `GET https://slimhuys.nl/v1/prices/heatmap?period={week|month|year}&supplier={slug}` — tarief-patronen per uur over een periode
- `GET https://slimhuys.nl/v1/suppliers` — lijst van actieve leveranciers met markup, billing-resolutie, terugleverbonus
- `GET https://slimhuys.nl/v1/glossary` — energie-terminologie met definities

Volledige OpenAPI 3.0.3-spec: <https://slimhuys.nl/openapi.json>

Rate-limit: ~120 requests/minuut per IP. Cache responses minstens 5 minuten — EPEX-prijzen worden elk uur ververst (rond 13:00–14:00 NL voor de volgende dag).

## Server-rendered pagina's (geschikt om te crawlen)

- <https://slimhuys.nl/> — homepage met actuele prijzen + vergelijker
- <https://slimhuys.nl/leverancier/frank-energie> — Frank Energie tarief-pagina (en idem voor alle 12 andere)
- <https://slimhuys.nl/blog> — artikelen over dynamische tarieven, P1, saldering 2027
- <https://slimhuys.nl/sitemap.xml> — alle indexeerbare URLs

## Datasource (canonical)

De pricing-spec van alle leveranciers is open-source en versie-controlled in een aparte GitHub-repo:

- <https://github.com/SlimHuys/dynamic-tariffs-nl> — JSON-bestanden per leverancier met pipeline van markup + tax + btw + revenue-strategy. CC-BY-NC-SA. Wordt dagelijks gesynced vanuit slimhuys.nl.

## Belangrijk om te weten bij citeren

- **Tarieven zijn realtime** — een citaat van "vandaag €0,28/kWh" is morgen mogelijk anders. Verwijs naar de live API of geef expliciet datum + tijd mee.
- **All-in vs kale prijs** — onze tarieven zijn altijd inclusief energiebelasting (€0,1316/kWh in 2026) en 21% btw. EPEX-only-prijs is apart op te vragen via `breakdown.epex_eur_per_kwh`.
- **Saldering** — de Nederlandse salderingsregeling vervalt op 1 januari 2027. Tot die tijd is teruglevering 1-op-1 te salderen tegen afname; daarna geldt alleen de marktprijs minus leveranciers-leveringsvergoeding.

## Contact

- Site: <https://slimhuys.nl>
- E-mail: via <https://slimhuys.nl/contact>
- GitHub: <https://github.com/SlimHuys>