Elektros kainos biržoje API

Naudodamiesi API, galite automatizuoti elektros prietaisų energijos vartojimą pagal elektros kainą Nord Pool biržoje.

Nesudėtingas programinis kodas išmanioje rėlėje ar mikrovaldiklyje tikrina kainas ir įjungia/išjungia prietaisus pagal kainą ir poreikį. Pavyzdys su Shelly 1PM rėle.

Pastaba: pavyzdžiuose naudojamas "demo" raktas grąžina retai atsinaujinančius duomenis. Susisiekite dėl nemokamo asmeninio API key.
Pastaba: nekvieskite API dažniau nei kas 10 sekundžių (galimas IP blokavimas).

API užklausa kainai šiuo metu: /api/v2/current?apikey=demo
Atsakymo pavyzdys:

{
  "current": {
    "startTimeLocal": "13:45:00",
    "startTimeUTC": "11:45:00",
    "price": "0.115",
    "rank": 42
  }
}

Atsakyme yra einamojo intervalo pradžios laikas, kaina ir reitingas pagal brangumą paroje (1-96).

Su parametru with_next=true atsakyme bus ir sekančių 16 intervalų duomenys: /api/v2/current?with_next=true&apikey=demo

{
  {
  "current": {
    "startTimeLocal": "14:15:00",
    "startTimeUTC": "12:15:00",
    "price": "0.119",
    "rank": 48
  },
  "next": [
    {
      "startTimeLocal": "14:30:00",
      "startTimeUTC": "12:30:00",
      "price": "0.122",
      "rank": 54
    },
    ...
  ]
}
}

API užklausa šios dienos kainoms: /api/v2/today?apikey=demo
Atsakymo pavyzdys:

{
  "date": "2025-12-11",
  "intervals": [
    {
      "startTimeLocal": "00:00:00",
      "startTimeUTC": "22:00:00",
      "price": "0.016",
      "rank": 4
    },
    {
      "startTimeLocal": "00:15:00",
      "startTimeUTC": "22:15:00",
      "price": "0.014",
      "rank": 3
    },
    ...
  ]
}

API užklausa kainai šiuo metu: /api/current?apikey=demo
Atsakymo pavyzdys: {"price":"0.295", "hour":16, "priceRating":1}. Kaina šiuo metu, einama valanda ir šio intervalo reitingas pagal brangumą paroje (1-96).

Pastaba: Ši užklausa (aktyvi nuo 2022m.) dėl esamų naudotojų dar pilnai veikia su "demo" raktu. Planuojama "demo" rakto apribojimo data 2026.03.01.