Dataene, rett fra plattformen
Det samme laget som sidene på nettstedet selv leser fra. Ingen nøkkel, ingen registrering, JSON over HTTP. Hvert svar oppgir hvilken kilde det kommer fra, hvilket tidspunkt det gjelder, og hvor ferskt det er.
Kraftsystemet i sanntid
Forbruk, produksjon per kilde og utveksling over grensene, slik systemoperatørene publiserer dem. Åpent.
| Adresse | Hva det returnerer | Frekvens |
|---|---|---|
/api/v1/countries |
Alle land på plattformen, med sonene sine og dekningsstatus. | Endres sjelden — når registeret endres. |
/api/v1/countries/:iso2/latest |
Et øyeblikksbilde for ett land: forbruk, produksjon per kilde, balanse ved grensene. | Så ofte som operatøren publiserer — fra hvert tiende sekund til hver time. |
/api/v1/countries/:iso2/history |
En tidsserie for ett land, over et valgt tidsrom. | Samme frekvens som øyeblikksbildet. |
/api/v1/europe/latest |
Europatotalen og hvert land som inngår i den. | Ett minutt. |
/api/v1/status |
Status for innsamlingen: hvilken kilde som publiserte sist, og når. | Kontinuerlig. |
/api/v1/licenses |
Hva plattformen har lov til å gjøre med dataene fra hver kilde. | Når vilkårene for en kilde endres. |
/api/v1/search |
Søk i land, soner og begreper. | Kontinuerlig. |
Døgnmarkedet
Prisene fra auksjonen for neste døgn, per budområde. Stengt inntil videre — se nedenfor hvorfor.
| Adresse | Hva det returnerer | Frekvens |
|---|---|---|
/api/v1/prices/latest451 · lisens |
Den siste kjente prisen for hver sone. | Én gang om dagen, etter auksjonen. |
/api/v1/prices/zones451 · lisens |
Budområdene, med tidssone og valuta for hvert av dem. | Endres sjelden. |
/api/v1/prices/date451 · lisens |
Alle soner, for et valgt leveringsdøgn. | Daglig. |
/api/v1/prices/country/:iso2451 · lisens |
Prisene i ett land, for hver av sonene. | Daglig. |
/api/v1/prices/:zone/history451 · lisens |
Historikken for én sone, intervall for intervall. | Daglig. |
/api/v1/prices/:zone/summary451 · lisens |
Gjennomsnitt, minimum, maksimum og kvantiler per dag, uke eller måned. | Daglig. |
/api/v1/market/cheapest451 · lisens |
Sonene med lavest snittpris for dagen. | Daglig. |
/api/v1/market/expensive451 · lisens |
Sonene med høyest snittpris for dagen. | Daglig. |
/api/v1/market/spreads451 · lisens |
Forskjellen mellom den billigste og den dyreste timen, per sone. | Daglig. |
/api/v1/market/cheapest-window451 · lisens |
Det billigste sammenhengende vinduet på N timer i en sone. | Daglig. |
/api/v1/market/weekly451 · lisens |
Ukerapporten, når uken er over. | Ukentlig. |
Hvorfor prisrutene svarer med 451
Markedsdataene kommer fra transparensplattformen til ENTSO-E. Vi samler dem inn og viser dem på nettstedet med kilden oppgitt ved hvert tall, men å videreformidle dem gjennom et API er ikke det samme som å vise dem, og vilkårene for gjenbruk er ennå ikke kontrollert og registrert av oss.
Inntil da returnerer prisrutene 451 — koden for «ikke tilgjengelig av juridiske grunner» — i stedet for i det stille å levere noe vi ikke har rett til å levere. Lisenssystemet fungerer per kilde, ikke per land, så det krever ingen kodeendring å åpne dem.
Regler for god oppførsel
Det finnes ingen grense for antall forespørsler, og vi vil gjerne slippe å innføre en. Svarene har cache-control: respekter den, så får du nøyaktig de samme tallene uten å spørre to ganger. Sanntidsdata endres ikke oftere enn operatøren publiserer — én forespørsel i sekundet for et land som publiserer hver time, gir ikke noe nytt.
Hvis du bruker dataene offentlig, oppgi den opprinnelige kilden (systemoperatøren eller ENTSO-E), ikke vårt navn: vi transporterer dataene, vi produserer dem ikke.
Se også: Datakilder · Metode · Systemstatus · llms.txt