Nord Pool integration for Home Assistant

📢 Actively Maintained Fork This is an actively maintained fork of the original custom-components/nordpool integration with new features and bug fixes. Originally created by @hellowlol and contributors.

Nord Pool is a service provider that operates an electricity market and power system services, including the exchange of electricity on a spot market Nordics and Baltic countries.

This integration provides spot market electricity prices for the Nordic, Baltic and part of Western Europe with support for both 15-minute and hourly intervals.

The Nordpool sensor provides the current price with today's and tomorrow's prices as attributes. Prices become available around 13:00 CET.

✨ What's New in This Fork

v0.0.19 (Latest) - October 1, 2025

• ✅ 15-minute period support - Nord Pool transitioned from hourly to 15-minute intervals
• ✅ Automatic period detection - Seamlessly handles both period types
• ✅ Adaptive calculations - Peak/off-peak pricing adjusts to data granularity
• ✅ Full backward compatibility - Existing configurations work unchanged
• ✅ Automated releases - Releases automatically created when PRs are merged
• ✅ Easy installation - One-click HACS repository addition

See CHANGELOG.md for complete version history.

Why This Fork?

Feature	Original Repo	This Fork
15-minute support	❌	✅
Active maintenance	❌	✅
Automated releases	❌	✅
Issue responses	Slow/None	Fast

Migrating from Original Repository

Already using custom-components/nordpool? Here's how to switch:

1. Remove the old integration via HACS
2. Add https://github.com/Tsopic/nordpool as a custom HACS repository
3. Install the new version from the custom repository
4. Your existing configuration will continue to work unchanged!

ApexCharts card is recommended for visualization of the data in Home Assistant.

Table of Contents

Installation
Usage
Other
Troubleshooting

Getting started

• Video tutorial: variable energy prices in HA by Smart Home Junkie
• Written guide: Nordpool and ApexChart by Creating Smart Home
• Community: Nordpool integration on Home Assistant Community
• Cheapest hours sensor: Cheapest Energy Hours to create an sensor with the cheapest hours

Installation

Option 1: HACS (Recommended)

Add Custom Repository

1. Open HACS in Home Assistant
2. Click on Integrations
3. Click the three dots in the top right corner
4. Select Custom repositories
5. Add this repository URL: https://github.com/Tsopic/nordpool
6. Select category: Integration
7. Click Add

Install Integration

1. Click + Explore & Download Repositories
2. Search for Nord Pool
3. Click on it and select Download
4. Restart Home Assistant

Note: This is a custom repository fork. Use the URL above instead of searching for the original nordpool integration.

Option 2: Manual

Download the latest release

cd YOUR_HASS_CONFIG_DIRECTORY    # same place as configuration.yaml
mkdir -p custom_components/nordpool
cd custom_components/nordpool
unzip nordpool-X.Y.Z.zip
mv nordpool-X.Y.Z/custom_components/nordpool/* .

Usage

Configuration Variables

Configuration	Required	Description
Region	yes	Country/region to get the energy prices for. See Country/region codes below for details.
Currency	no	Default: local currency Currency used to fetch the prices from the API.
Include VAT	no	Default: true Add Value Added Taxes (VAT) or not.
Decimal precision	no	Default: 3 Energy price rounding precision.
Low price percentage	no	Default: 1 Percentage of average price to set the low price attribute. IF period_price < average * low_price_cutoff THEN low_price = True ELSE low_price = False
Price in cents	no	Default: false Display price in cents in stead of (for example) Euros.
Energy scale	no	Default: kWh Price displayed for MWh, kWh or Wh.
Period type	no	Default: 15min Price period resolution: 15min for 15-minute intervals or hour for hourly. The actual period is auto-detected from API data.
Additional Cost	no	default {{0.0|float}} Template to specify additional cost to be added. See Additional Costs for more details.

Option 1: UI

• Go to Settings -> Devices & Services
• Select + Add Integration
• Search for nordpool and select it
• Fill in the required values and press Submit

Tip: By default, the integration will create a device with the name nordpool_<energy_scale>_<region>_<currency>_<some-numbers>. It is recommended to rename the device and all its entities to nordpool. If you need to recreate your sensor (for example, to change the additional cost), all automations and dashboards keep working.

Option 2: YAML

Set up the sensor using in configuration.yaml.

Minimal configuration:

sensor:
  - platform: nordpool
    region: "NO1"

Example configuration:

sensor:
  - platform: nordpool
    # Country/region to get the energy prices for.
    region: "NO1"

    # Override HA local currency used to fetch the prices from the API.
    currency: "EUR"

    # Add Value Added Taxes (VAT)?
    VAT: True

    # Energy price rounding precision.
    precision: 3

    # Percentage of average price to set the low price attribute
    # low_price = period_price < average * low_price_cutoff
    low_price_cutoff: 0.95

    # Display price in cents in stead of (for example) Euros.
    price_in_cents: false

    # Price displayed for MWh, kWh or Wh
    price_type: kWh

    # Period type: 15min (default) or hour
    # The actual period is auto-detected from API response
    period_type: 15min

    # Template to specify additional cost to be added to the tariff.
    # The template price is in EUR, DKK, NOK or SEK (not in cents).
    # For example: "{{ current_price * 0.19 + 0.023 | float}}"
    additional_costs: "{{0.0|float}}"

Regions

See the Nord Pool region map for details

Country	Region code
Austria	AT
Belgium	BE
Denmark	DK1, DK2
Estonia	EE
Finland	FI
France	FR
Germany	DE-LU
Great-Britain	Not yet available in this version
Latvia	LV
Lithuania	LT
Luxenburg	DE-LU
Netherlands	NL
Norway	Oslo (NO1) Kr.sand (NO2) Tr.heim / Molde (NO3) Tromso (NO4) Bergen (NO5)
Poland	Not yet available in this version
Sweden	SE1, SE2, SE3, SE4

Additional costs

The idea behind additional_costs is to allow the users to add costs related to the official price from Nordpool:

• Add simple or complex tariffs
• Calculate VAT

There are two special special arguments in that can be used in the template (in addition to all default from Homeassistant):

• now(): this always refer to the current period of the price (15-minute or hourly depending on configuration)
• current_price: price for the current period. This can be used for example be used to calculate your own VAT or add overhead cost.

Note: When configuring Nordpool using the UI, things like VAT and additional costs cannot be changed. If your energy supplier or region changes the additional costs or taxes on a semi-regular basis, the YAML configuration or a helper (example 4) work best.

Example 1: Overhead per kWh

Add 1,3 cents per kWh overhead cost to the current hour's price

{{ 0.013 | float }}

Example 2: Percentage (VAT)

Add 19 % VAT of the current hour's price

{{ (current_price * 0.19) | float }}

Example 3: Overhead and VAT

Add 1,3 cents per kWh overhead cost, 0.002 flat tax and 19% VAT to the current hour's price

{{ (0.013 + 0.002 + (current_price * 0.19)) | float }}

Example 4: Helper

Add 21% tax and overhead cost stored in a helper

'''{{ (current_price * 0.21) + states('input_number.additionele_kosten') | float(0) }}'''

Example 5: Seasonal peek and off-peek overhead

{% set s = {
    "hourly_fixed_cost": 0.5352,
    "winter_night": 0.265,
    "winter_day": 0.465,
    "summer_day": 0.284,
    "summer_night": 0.246,
    "cert": 0.01
}
%}
{% if now().month >= 5 and now().month < 11 %}
    {% if now().hour >= 6 and now().hour < 23 %}
        {{ s.summer_day + s.hourly_fixed_cost + s.cert | float }}
    {% else %}
        {{ s.summer_night + s.hourly_fixed_cost + s.cert|float }}
    {% endif %}
{% else %}
    {% if now().hour >= 6 and now().hour < 23 %}
        {{ s.winter_day + s.hourly_fixed_cost + s.cert | float }}
    {% else %}
        {{ s.winter_night + s.hourly_fixed_cost + s.cert | float }}
    {% endif %}
{% endif %}

Other

Extra state attributes

• average: An average of every today
• off_peak_1: Off peak 1 refers to the average price of the time period from midnight to 8am
• off_peak_2: Off peak 2 refers to the average price of the time period from 8pm to midnight
• peak: Peak refers to the average price of the period from 8am to 8pm
• min: Lowest value today
• max: Highest value today
• mean: Actually just median of all values
• unit: what that of Unit, eg: kWh
• currency: What type of Currency
• country: What Country data is fetched for
• region: The specific region of prices
• low_price: If price is below low_price_threshold
• price_percent_to_average:
• today: List of all values
• tomorrow: list of all values
• tomorrow_valid: If tomorrow's values are in yet
• raw_today: Array of all values
• raw_tomorrow: Array of values
• current_price: What the current price is
• additional_costs_current_hour: If there is any additional costs this period
• price_in_cents: Boolean if prices is in cents
• period_type: The detected period type (15min or hour)

Actions

Actions has recently been added. The action will just forward the raw response from the Nordpool API so you can capture the value your are interested in.

Example for an automation that get the last months averge price.

alias: Example automation action call with storing with parsing and storing result
triggers: null
actions:
  - action: nordpool.yearly
    data:
      currency: NOK
      area: NO2
      year: "2024"
    response_variable: np_result
  - action: input_text.set_value
    target:
      entity_id: input_text.test
    data:
      value: "{{np_result.prices[0].averagePerArea.NO2 | float}}"
mode: single

Troubleshooting

Debug logging

Add this to your configuration.yaml and restart Home Assistant to debug the component.

logger:
  logs:
    nordpool: debug
    custom_components.nordpool: debug
    custom_components.nordpool.sensor: debug
    custom_components.nordpool.aio_price: debug

License

This project is licensed under the MIT License - see the LICENSE file for details.

Originally forked from custom-components/nordpool by @hellowlol and contributors.