Openbare GETCORS open

Openbare API

13 endpoints

JSON over GET. Day-ahead na de veiling, de meerdaagse prognose hooguit elk kwartier.

Routes

Allemaal JSON. Anoniem op IP-limiet, met sleutel een hoger plafond.

GET/api/v1/forecast?days=8

Volledige horizon: officiële uren + prognose, betrouwbaarheid, drivers en toelichting.

20 / min / IPs-maxage=180

GET/api/v1/prices

Alleen bekende day-ahead. Dit is grotendeels statisch tot de volgende veiling.

60 / min / IPs-maxage=300

GET/api/v1/quarters?from=2026-02-01&to=2026-02-07

NL EPEX-kwartieren vanaf 1 okt 2025. Voor analyse, niet voor de prognose. Max 186 dagen per request.

40 / min / IPs-maxage=300

GET/api/v1/history?from=2015-01-01&to=2015-12-31

Archief voor de UI: uurprijzen vanaf 2015, kwartieren vanaf 1 okt 2025. Max 366 dagen. /quarters blijft 15-min-only.

40 / min / IPs-maxage=300

GET/api/v1/issued?from=2026-08-22&to=2026-08-29&leadDays=3

Bewaarde uurprognoses van de hele 8-daagse horizon. Zonder extra param: laatste gok per uur. leadDays=1–8: die voorsprong. at=: één snapshot.

40 / min / IPs-maxage=120

GET/api/v1/neighbors

Laatst bekende day-ahead van NL, DE-LU, BE, FR, DK1 en NO2.

60 / min / IPs-maxage=300

GET/api/v1/windows

Goedkoopste blokken: laden 3u/4u, wassen 2u, en het kortste slot.

40 / min / IPs-maxage=180

GET/api/v1/patterns?period=era&grain=week

Uur×weekdag of uur×maand. period=30, 90, era, all of een jaar vanaf 2015. grain=week of month.

40 / min / IPs-maxage=3600

GET/api/v1/facts

Records uit NL-uurprijzen: hoogste/laagste, reeksen, wilde dagen, zonnedip.

40 / min / IPs-maxage=3600

GET/api/v1/health

Bronstatus, Postgres-historie, LLM-sleutel, en of ENTSO-E aanstaat.

120 / min / IPs-maxage=30

GET/api/v1/all-in

Beursprijs omgerekend naar wat een kWh werkelijk kost: opslag + energiebelasting + btw. Netbeheer zit er bewust niet in (vaste jaarkosten). Parameters: provider, surcharge (ct/kWh), monthlyFee, gridEurYear.

40 / min / IPs-maxage=180

GET/api/v1/tariffs

Opslag en vastrecht per dynamische leverancier, met bron, publicatiedatum en hoe oud de waarneming is (staleDays). POST met x-ingest-key ververst ze.

60 / min / IPs-maxage=600

POST/api/v1/ingest

Eén rustige backfill-stap: 60 dagen Open-Meteo en/of 30 dagen Energy Charts. Schrijft naar de database, dus alleen met header x-ingest-key.

20 / min · vereist INGEST_KEYniet gecachet

Sleutel en limieten

Anoniem per IP. Met x-api-key of Authorization: Bearer (zelfde waarde als API_KEY) geldt 300/min.

curl -s "https://voorbeeld.nl/api/v1/forecast?days=8" \
  -H "x-api-key: $API_KEY"

Headers: X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After en Cache-Control.

ENTSO-E token

De Transparency Platform toont geen API-key totdat je toegang hebt. Daarna komen onbalans en NL-intraday mee.

Account op transparency.entsoe.eu en e-mail bevestigen.
Mail [email protected] met onderwerp RESTful API access en je geregistreerde e-mail.
Na goedkeuring: My Account Settings → Web API Security Token.
Zet die in ENTSOE_SECURITY_TOKEN. /api/v1/health toont dan entsoe: true.

Openbare GETCORS open

Openbare API

13 endpoints

JSON over GET. Day-ahead na de veiling, de meerdaagse prognose hooguit elk kwartier.

Routes

Allemaal JSON. Anoniem op IP-limiet, met sleutel een hoger plafond.

GET/api/v1/forecast?days=8

Volledige horizon: officiële uren + prognose, betrouwbaarheid, drivers en toelichting.

20 / min / IPs-maxage=180

GET/api/v1/prices

Alleen bekende day-ahead. Dit is grotendeels statisch tot de volgende veiling.

60 / min / IPs-maxage=300

GET/api/v1/quarters?from=2026-02-01&to=2026-02-07

NL EPEX-kwartieren vanaf 1 okt 2025. Voor analyse, niet voor de prognose. Max 186 dagen per request.

40 / min / IPs-maxage=300

GET/api/v1/history?from=2015-01-01&to=2015-12-31

Archief voor de UI: uurprijzen vanaf 2015, kwartieren vanaf 1 okt 2025. Max 366 dagen. /quarters blijft 15-min-only.

40 / min / IPs-maxage=300

GET/api/v1/issued?from=2026-08-22&to=2026-08-29&leadDays=3

Bewaarde uurprognoses van de hele 8-daagse horizon. Zonder extra param: laatste gok per uur. leadDays=1–8: die voorsprong. at=: één snapshot.

40 / min / IPs-maxage=120

GET/api/v1/neighbors

Laatst bekende day-ahead van NL, DE-LU, BE, FR, DK1 en NO2.

60 / min / IPs-maxage=300

GET/api/v1/windows

Goedkoopste blokken: laden 3u/4u, wassen 2u, en het kortste slot.

40 / min / IPs-maxage=180

GET/api/v1/patterns?period=era&grain=week

Uur×weekdag of uur×maand. period=30, 90, era, all of een jaar vanaf 2015. grain=week of month.

40 / min / IPs-maxage=3600

GET/api/v1/facts

Records uit NL-uurprijzen: hoogste/laagste, reeksen, wilde dagen, zonnedip.

40 / min / IPs-maxage=3600

GET/api/v1/health

Bronstatus, Postgres-historie, LLM-sleutel, en of ENTSO-E aanstaat.

120 / min / IPs-maxage=30

GET/api/v1/all-in

40 / min / IPs-maxage=180

GET/api/v1/tariffs

Opslag en vastrecht per dynamische leverancier, met bron, publicatiedatum en hoe oud de waarneming is (staleDays). POST met x-ingest-key ververst ze.

60 / min / IPs-maxage=600

POST/api/v1/ingest

Eén rustige backfill-stap: 60 dagen Open-Meteo en/of 30 dagen Energy Charts. Schrijft naar de database, dus alleen met header x-ingest-key.

20 / min · vereist INGEST_KEYniet gecachet

Sleutel en limieten

Anoniem per IP. Met x-api-key of Authorization: Bearer (zelfde waarde als API_KEY) geldt 300/min.

curl -s "https://voorbeeld.nl/api/v1/forecast?days=8" \
  -H "x-api-key: $API_KEY"

Headers: X-RateLimit-Limit, X-RateLimit-Remaining, Retry-After en Cache-Control.

ENTSO-E token

De Transparency Platform toont geen API-key totdat je toegang hebt. Daarna komen onbalans en NL-intraday mee.

Account op transparency.entsoe.eu en e-mail bevestigen.
Mail [email protected] met onderwerp RESTful API access en je geregistreerde e-mail.
Na goedkeuring: My Account Settings → Web API Security Token.
Zet die in ENTSOE_SECURITY_TOKEN. /api/v1/health toont dan entsoe: true.