API

Dataene, direkte fra platformen

Det samme datalag, som webstedets egne sider læser fra. Ingen nøgle, ingen registrering, JSON over HTTP. Hvert svar oplyser, hvilken kilde det kommer fra, hvilket tidspunkt det gælder, og hvor friskt det er.

Elsystemet i realtid

Forbrug, produktion fordelt på kilde og grænseoverskridende udveksling, som transmissionssystemoperatørerne offentliggør dem. Åbent.

Adresse Hvad den returnerer Hyppighed
/api/v1/countries Alle lande på platformen med deres zoner og dækningsstatus. Ændres sjældent — når registret ændres.
/api/v1/countries/:iso2/latest Et øjebliksbillede af et land: forbrug, produktion fordelt på kilde, balance ved grænserne. Så ofte som landets operatør offentliggør — fra 10 sekunder til en time.
/api/v1/countries/:iso2/history En tidsserie for ét land over et valgt interval. Samme hyppighed som øjebliksbilledet.
/api/v1/europe/latest Den europæiske total og alle lande, der indgår i den. Ét minut.
/api/v1/status Indsamlingens status: hvilken kilde der sidst har offentliggjort, og hvornår. Løbende.
/api/v1/licenses Hvad platformen må gøre med hver kildes data. Når en kildes vilkår ændres.
/api/v1/search Søgning på tværs af lande, zoner og begreber. Løbende.

Day-ahead-markedet

De priser, der er fastsat på auktion for det følgende døgn, efter prisområde. Lukket indtil videre — se nedenfor hvorfor.

Adresse Hvad den returnerer Hyppighed
/api/v1/prices/latest451 · licens Den senest kendte pris for hver zone. Én gang om dagen, efter auktionen.
/api/v1/prices/zones451 · licens Prisområderne med hver zones tidszone og valuta. Ændres sjældent.
/api/v1/prices/date451 · licens Alle zoner for et valgt leveringsdøgn. Dagligt.
/api/v1/prices/country/:iso2451 · licens Et lands priser for hver af landets zoner. Dagligt.
/api/v1/prices/:zone/history451 · licens En zones historik, interval for interval. Dagligt.
/api/v1/prices/:zone/summary451 · licens Gennemsnit, minimum, maksimum og kvantiler pr. dag, uge eller måned. Dagligt.
/api/v1/market/cheapest451 · licens Zonerne med dagens laveste gennemsnitspris. Dagligt.
/api/v1/market/expensive451 · licens Zonerne med dagens højeste gennemsnitspris. Dagligt.
/api/v1/market/spreads451 · licens Forskellen mellem den billigste og den dyreste time pr. zone. Dagligt.
/api/v1/market/cheapest-window451 · licens Det billigste sammenhængende vindue på N timer i en zone. Dagligt.
/api/v1/market/weekly451 · licens Ugerapporten, når ugen er afsluttet. Ugentligt.

Hvorfor prisruterne svarer med 451

Markedsdataene kommer fra ENTSO-E's gennemsigtighedsplatform. Vi indsamler dem og viser dem på siden med kilden angivet ved hvert tal, men at videredistribuere dem via et API er ikke det samme som at vise dem, og vilkårene for genbrug er endnu ikke verificeret og registreret af os.

Indtil da returnerer prisruterne 451 — koden for »utilgængelig af juridiske årsager« — i stedet for i al stilhed at levere noget, vi ikke har ret til at levere. Licenssystemet fungerer pr. kilde, ikke pr. land, så det kræver ingen kodeændring at åbne dem.

Regler for god opførsel

Der er ingen grænse for antallet af forespørgsler, og vi vil gerne undgå, at der bliver brug for en. Svarene har cache-control: Respektér den, så får du præcis de samme tal uden at spørge to gange. Realtidsdata ændrer sig ikke oftere, end operatøren offentliggør dem — én forespørgsel i sekundet for et land, der offentliggør hver time, giver intet nyt.

Hvis du bruger dataene offentligt, så angiv den oprindelige kilde (transmissionssystemoperatøren eller ENTSO-E), ikke vores navn: Vi transporterer dataene, vi producerer dem ikke.

Se også: Datakilder · Metode · Systemstatus · llms.txt