# ENTSO-E Binding

This binding fetches day-ahead energy spot prices from ENTSO-E, the European Network of Transmission System Operators for Electricity.

Users can select a specific area to retrieve the relevant energy prices. This binding helps users monitor and manage their energy consumption based on real-time pricing data. It is recommended to use this binding together with a currency provider (e.g. Freecurrency binding (opens new window)) for exchanging euro spot prices to local currency.

# Supported Things

  • day-ahead: This is the main and single Thing of the binding.

# Thing Configuration

To access the ENTSO-E Transparency Platform API, users need a security token for authentication and authorization. This token ensures secure access to the platform's data and services. For detailed instructions on obtaining this token, you can refer to the ENTSO-E API Guide 2. Authentication and Authorisation (opens new window).

Mandatory parameters of the Thing are security token and area. Optional parameters are historic days, resolution, availability hour for day ahead spot prices and request timeout.

# entsoe Thing Configuration

Name Type Description Default Required Advanced
securityToken text Security token to fetch from ENTSO-E N/A yes no
area text Area N/A yes no
historicDays integer Historic days to get prices from (will use exchange rate as of today) 0 no no
resolution text Data resolution PT60M no no
spotPricesAvailableCetHour integer Which CET hour binding assumes new spot prices for next day is available 13 no yes
requestTimeout integer Request timeout in seconds 30 no yes

# Channels

Binding has one channel.

spot-price which are the values fetched from ENTSO-E and persisted in openHAB as time series. The price is per kWh at your selected base currency.

Channel Type Read/Write Description
spot-price Number:EnergyPrice R Spot prices

# Thing Configuration

Thing entsoe:day-ahead:eda "Entsoe Day Ahead" [ securityToken="your-security-token", area="10YNO-3--------J", historicDays=14 ] 

# Item Configuration

Number:EnergyPrice energySpotPrice "Current Spot Price" <price> { channel="entsoe:day-ahead:eda:spot-price" }

# Value-Added Tax

VAT is not included in any of the prices. To include VAT for items linked to the Number:EnergyPrice channel, the VAT profile (opens new window) can be used. This must be installed separately. Once installed, simply select "Value-Added Tax" as Profile when linking an item.

# Total Price

Please note: There is no channel providing the total price. Instead, create a group item with SUM as aggregate function and add the individual price items as children. Read more about how to in this similar binding Energi Data Service (opens new window)

# Trigger Channels

Channel prices-received is triggered when new prices are available.

# Examples

examples.rules

rule "Spot prices received"
when
    Channel "entsoe:day-ahead:eda:prices-received" triggered
then
    // Do something within rule
    logInfo("ENTSO-E Rule", "ENTSO-E channel triggered, new spot prices available")
end