API

Uppgifterna, direkt från plattformen

Samma lager som webbplatsens egna sidor läser. Ingen nyckel, ingen registrering, JSON över HTTP. Varje svar anger vilken källa det kommer från, vilken tidpunkt det avser och hur färskt det är.

Elsystemet, i realtid

Förbrukning, produktion per källa och gränsöverskridande utbyte, så som stamnätsoperatörerna publicerar dem. Öppet.

Adress Vad den returnerar Frekvens
/api/v1/countries Alla länder på plattformen, med deras zoner och täckningsstatus. Ändras sällan — när registret ändras.
/api/v1/countries/:iso2/latest Ögonblicksbild av ett land: förbrukning, produktion per källa, balans vid gränserna. Så ofta som landets operatör publicerar — från var tionde sekund till en gång i timmen.
/api/v1/countries/:iso2/history En tidsserie för ett land, över ett valt intervall. Samma frekvens som ögonblicksbilden.
/api/v1/europe/latest Den europeiska summan och varje land som ingår i den. En minut.
/api/v1/status Insamlingens status: vilken källa som publicerade senast, och när. Löpande.
/api/v1/licenses Vad plattformen får göra med varje källas data. När en källas villkor ändras.
/api/v1/search Sökning bland länder, zoner och termer. Löpande.

Dagen före-marknaden

Priserna som auktionerats för nästa dygn, per elområde. Stängt tills vidare — se nedan varför.

Adress Vad den returnerar Frekvens
/api/v1/prices/latest451 · licens Det senast kända priset för varje zon. En gång om dagen, efter auktionen.
/api/v1/prices/zones451 · licens Elområdena, vart och ett med sin tidszon och valuta. Ändras sällan.
/api/v1/prices/date451 · licens Alla zoner, för en vald leveransdag. Dagligen.
/api/v1/prices/country/:iso2451 · licens Ett lands priser, för var och en av dess zoner. Dagligen.
/api/v1/prices/:zone/history451 · licens En zons historik, intervall för intervall. Dagligen.
/api/v1/prices/:zone/summary451 · licens Genomsnitt, lägsta, högsta och kvantiler per dag, vecka eller månad. Dagligen.
/api/v1/market/cheapest451 · licens Zonerna med dagens lägsta genomsnittspris. Dagligen.
/api/v1/market/expensive451 · licens Zonerna med dagens högsta genomsnittspris. Dagligen.
/api/v1/market/spreads451 · licens Skillnaden mellan den billigaste och den dyraste timmen, per zon. Dagligen.
/api/v1/market/cheapest-window451 · licens Det billigaste sammanhängande fönstret på N timmar i en zon. Dagligen.
/api/v1/market/weekly451 · licens Veckorapporten, när veckan har avslutats. Varje vecka.

Varför prisvägarna svarar med 451

Marknadsdata kommer från ENTSO-E:s transparensplattform. Vi samlar in dem och visar dem på webbplatsen med källan angiven bredvid varje siffra, men att vidaredistribuera dem via ett API är inte samma sak som att visa dem, och villkoren för återanvändning har vi ännu inte kontrollerat och registrerat.

Till dess returnerar prisvägarna 451 — koden för ”inte tillgängligt av juridiska skäl” — i stället för att i tysthet leverera något som vi inte har rätt att leverera. Licenssystemet fungerar per källa, inte per land, så det krävs ingen kodändring för att öppna dem.

Regler för gott uppförande

Det finns ingen gräns för antalet anrop, och vi skulle gärna slippa införa en. Svaren har cache-control: respektera den så får du exakt samma siffror utan att fråga två gånger. Realtidsdata ändras inte oftare än operatören publicerar — ett anrop i sekunden för ett land som publicerar varje timme ger inget nytt.

Om du använder uppgifterna offentligt, ange den ursprungliga källan (stamnätsoperatören eller ENTSO-E), inte vårt namn: vi transporterar uppgifterna, vi producerar dem inte.

Se även: Datakällor · Metod · Systemstatus · llms.txt