API

De gegevens, rechtstreeks van het platform

Dezelfde laag die de eigen pagina’s van de site lezen. Geen sleutel, geen registratie, JSON over HTTP. Elk antwoord vermeldt uit welke bron het komt, op welk moment het betrekking heeft en hoe vers het is.

Het elektriciteitssysteem, in realtime

Verbruik, productie per bron en grensoverschrijdende uitwisseling, zoals de transmissiesysteembeheerders ze publiceren. Open.

Adres Wat het teruggeeft Frequentie
/api/v1/countries Elk land op het platform, met zijn zones en dekkingsstatus. Verandert zelden — wanneer het register verandert.
/api/v1/countries/:iso2/latest Momentopname van een land: verbruik, productie per bron, grenssaldo. Zo vaak als de netbeheerder publiceert — van 10 seconden tot een uur.
/api/v1/countries/:iso2/history Een tijdreeks voor één land, over een gekozen periode. Dezelfde frequentie als de momentopname.
/api/v1/europe/latest Het Europese totaal en elk land dat erin meetelt. Eén minuut.
/api/v1/status De stand van de gegevensverzameling: welke bron het laatst publiceerde, en wanneer. Doorlopend.
/api/v1/licenses Wat het platform met de gegevens van elke bron mag doen. Wanneer de voorwaarden van een bron veranderen.
/api/v1/search Zoeken in landen, zones en termen. Doorlopend.

De day-aheadmarkt

De prijzen die voor de volgende dag zijn geveild, per biedzone. Voorlopig gesloten — zie hieronder waarom.

Adres Wat het teruggeeft Frequentie
/api/v1/prices/latest451 · licentie De laatst bekende prijs voor elke zone. Eén keer per dag, na de veiling.
/api/v1/prices/zones451 · licentie De biedzones, elk met tijdzone en munteenheid. Verandert zelden.
/api/v1/prices/date451 · licentie Alle zones, voor een gekozen leveringsdag. Dagelijks.
/api/v1/prices/country/:iso2451 · licentie De prijzen van een land, voor elk van zijn zones. Dagelijks.
/api/v1/prices/:zone/history451 · licentie De geschiedenis van een zone, interval per interval. Dagelijks.
/api/v1/prices/:zone/summary451 · licentie Gemiddelde, minimum, maximum en kwantielen per dag, week of maand. Dagelijks.
/api/v1/market/cheapest451 · licentie De zones met de laagste gemiddelde prijs van de dag. Dagelijks.
/api/v1/market/expensive451 · licentie De zones met de hoogste gemiddelde prijs van de dag. Dagelijks.
/api/v1/market/spreads451 · licentie Het verschil tussen het goedkoopste en het duurste uur, per zone. Dagelijks.
/api/v1/market/cheapest-window451 · licentie Het goedkoopste aaneengesloten venster van N uur in een zone. Dagelijks.
/api/v1/market/weekly451 · licentie Het weekrapport, zodra de week is afgesloten. Wekelijks.

Waarom de prijsroutes met 451 antwoorden

De marktgegevens komen van het ENTSO-E-transparantieplatform. We verzamelen ze en tonen ze op de site met de bron naast elk cijfer, maar ze via een API herverdelen is niet hetzelfde als ze tonen, en de voorwaarden voor hergebruik zijn door ons nog niet geverifieerd en geregistreerd.

Tot dan geven de prijsroutes 451 terug — de code voor “niet beschikbaar om juridische redenen” — in plaats van stilletjes iets te leveren waartoe we niet gerechtigd zijn. Het licentiesysteem werkt per bron, niet per land, dus om de routes open te stellen hoeft er geen code te veranderen.

Regels voor goed gedrag

Er is geen limiet op het aantal verzoeken, en we willen graag dat die ook niet nodig wordt. De antwoorden bevatten cache-control: respecteer dat en u krijgt precies dezelfde cijfers zonder twee keer te vragen. Realtimegegevens veranderen niet vaker dan hun netbeheerder publiceert — één verzoek per seconde voor een land dat per uur publiceert, levert niets nieuws op.

Als u de gegevens openbaar gebruikt, vermeld dan de oorspronkelijke bron (de transmissiesysteembeheerder of ENTSO-E), niet onze naam: wij vervoeren de gegevens, we produceren ze niet.

Zie ook: Gegevensbronnen · Methodologie · Systeemstatus · llms.txt