A Home Assistant integration for monitoring Polish electricity market prices (RCE - Rynkowa Cena Energii) from PSE (Polskie Sieci Elektroenergetyczne).
Instalation & Presentation: https://youtu.be/6N71uXgf9yc
- Open HACS in Home Assistant
- Search for "RCE PSE"
- DOWNLOAD the integration
- Restart Home Assistant
- Copy the
custom_components/rce_psefolder to your Home Assistantcustom_componentsdirectory - Restart Home Assistant
- Go to Settings > Integrations
- Click Add Integration and search for "RCE PSE"
- Configure the time window settings (see below)
- Click Submit to complete the setup
Here are two ready-to-use dashboard card configurations that showcase different ways to display energy price data:
This card provides advanced charting capabilities with professional-looking graphs and real-time price analysis. Perfect for users who want detailed visual analytics.
Configuration file: PL: examples/pl/card2_apexcharts_analysis.yaml EN: examples/en/card2_apexcharts_analysis.yaml
Requirements:
apexcharts-card- Install via HACS → "ApexCharts Card"
This card provides a comprehensive overview of current energy prices using standard Home Assistant entities. It's perfect for users who want a clean, simple display without additional dependencies.
Configuration file: PL: examples/pl/card1_basic_overview.yaml EN: examples/en/card1_basic_overview.yaml
Both cards can be easily customized to match your dashboard theme and specific needs. Simply copy the YAML configuration from the respective files and paste them into your Home Assistant dashboard in edit mode.
- Real-time price monitoring - Current electricity price with 15-minute precision
- Historical data - Previous hour pricing information
- Future price forecasting - Prices for next 1-3 hours ahead
- Daily statistics - Comprehensive price analysis (average, min, max, median)
- Tomorrow's data - Next day pricing available after 14:00 CET
- Price comparison - Today vs tomorrow percentage differences
- Optimal time windows - Configurable search for cheapest and most expensive periods
- Smart scheduling - Find best times for energy-intensive activities
- Peak avoidance - Identify and avoid high-cost electricity periods
- Time range display - Easy-to-read time ranges (e.g., "23:00 - 01:00")
- Hourly price averaging - Optional hourly price calculation for net-billing settlements
- Automatic updates - Data refreshed every 30 minutes from official PSE API
After installing the integration, you can configure it through the Home Assistant UI. The integration offers several customization options for optimal time windows that help you find the best electricity prices for your needs.
The integration provides advanced configuration options to customize how it searches for optimal electricity price windows:
These settings control how the integration finds the most economical electricity periods:
-
Start Hour (0-23): Beginning of the time window to search for cheapest hours
- Default: 0 (midnight)
- Example: Set to 22 to search from 10 PM onwards
-
End Hour (1-24): End of the time window to search for cheapest hours
- Default: 24 (midnight next day)
- Example: Set to 6 to search until 6 AM
-
Duration (hours) (1-24): Length of the cheapest continuous time window to find
- Default: 2 hours
- Example: Set to 3 to find 3-hour blocks of cheapest electricity
These settings control how the integration finds the most expensive electricity periods (useful for avoiding high-cost times):
-
Start Hour (0-23): Beginning of the time window to search for most expensive hours
- Default: 0 (midnight)
- Example: Set to 16 to search from 4 PM onwards
-
End Hour (1-24): End of the time window to search for most expensive hours
- Default: 24 (midnight next day)
- Example: Set to 20 to search until 8 PM
-
Duration (hours) (1-24): Length of the most expensive continuous time window to find
- Default: 2 hours
- Example: Set to 1 to find 1-hour blocks of most expensive electricity
This advanced option is useful for net-billing settlements due to prosumer metering with hourly accuracy despite 15-minute prices. When enabled, the integration calculates average prices for each hour from the published quarter-hour prices.
- Use Hourly Prices (true/false): Enable hourly price averaging
- Default: false (uses original 15-minute prices)
- When enabled: Calculates average price for each hour from 15-minute intervals
- Use case: Net-billing settlements according to Art. 4b sec. 11 of the Ustawa o OZE
How it works:
- When disabled: Uses original 15-minute price data from PSE API
- When enabled: Calculates hourly averages and applies the same price to all 15-minute intervals within each hour
- Example: If hour 0 has prices [300, 320, 340, 360] PLN, all four 15-minute intervals will show 330 PLN (average)
You can modify these settings at any time:
- Go to Configuration > Integrations
- Find "RCE PSE" in your integrations list
- Click Configure
- Adjust the settings as needed
- Click Submit to apply changes
The integration will automatically reload with your new settings.
Example 1: Night Charging (Electric Vehicle)
- Cheapest Hours: Start=22, End=6, Duration=4
- Find 4 cheapest consecutive hours between 10 PM and 6 AM
Example 2: Business Hours Optimization
- Most Expensive Hours: Start=8, End=18, Duration=2
- Avoid the 2 most expensive consecutive hours during business hours
Example 3: Peak Avoidance
- Most Expensive Hours: Start=17, End=21, Duration=1
- Identify the single most expensive hour during evening peak
When you configure custom time windows, the integration provides additional sensors:
For Today:
- Cheapest Window Start/End/Range
- Most Expensive Window Start/End/Range
For Tomorrow:
- Cheapest Window Start/End/Range
- Most Expensive Window Start/End/Range
These sensors automatically update based on your configured search parameters and provide precise time ranges in HH:MM format.
- Price - Current electricity price (with all daily prices as attributes)
- Price for kWh - Dedicated for HomeAssistant Energy dashboard (converts PLN/MWh to PLN/kWh, includes 23% VAT, negative prices converted to 0)
- Tomorrow Price - Tomorrow's price (available after 14:00 CET) (with all prices for the next day as attributes)
- Next Hour Price - Price for the next hour
- Price in 2 Hours - Price in 2 hours
- Price in 3 Hours - Price in 3 hours
- Previous Hour Price - Price from the previous hour
- Today Average Price - Average price for today
- Today Maximum Price - Highest price today
- Today Minimum Price - Lowest price today
- Today Median Price - Median price for today
- Today Current vs Average - Percentage difference between current and average price
- Tomorrow Average Price - Average price for tomorrow
- Tomorrow Maximum Price - Highest price tomorrow
- Tomorrow Minimum Price - Lowest price tomorrow
- Tomorrow Median Price - Median price for tomorrow
- Tomorrow vs Today Average - Percentage difference between tomorrow and today average
- Today Max Price Hour Start/End - When the highest price period starts/ends today
- Today Min Price Hour Start/End - When the lowest price period starts/ends today
- Today Max Price Range - Time range of highest price period (e.g., "17:00 - 18:00")
- Today Min Price Range - Time range of lowest price period (e.g., "02:00 - 03:00")
- Tomorrow Max Price Hour Start/End - When the highest price period starts/ends tomorrow
- Tomorrow Min Price Hour Start/End - When the lowest price period starts/ends tomorrow
- Tomorrow Max Price Range - Time range of highest price period tomorrow
- Tomorrow Min Price Range - Time range of lowest price period tomorrow
Based on your configuration settings, the integration provides additional sensors for optimal time windows:
- Today Cheapest Window Start - Start time of cheapest configured window
- Today Cheapest Window End - End time of cheapest configured window
- Today Cheapest Window Range - Time range of cheapest window (e.g., "23:00 - 01:00")
- Today Expensive Window Start - Start time of most expensive configured window
- Today Expensive Window End - End time of most expensive configured window
- Today Expensive Window Range - Time range of most expensive window
- Tomorrow Cheapest Window Start - Start time of cheapest configured window
- Tomorrow Cheapest Window End - End time of cheapest configured window
- Tomorrow Cheapest Window Range - Time range of cheapest window
- Tomorrow Expensive Window Start - Start time of most expensive configured window
- Tomorrow Expensive Window End - End time of most expensive configured window
- Tomorrow Expensive Window Range - Time range of most expensive window
All time values are provided in 24-hour format (HH:MM) and automatically update based on current market data and your configuration settings.
The integration provides binary sensors that indicate when you are currently within specific price windows. These sensors are perfect for automation triggers and dashboard indicators.
These sensors indicate whether you are currently within the most expensive or cheapest price periods for today:
- Today Min Price Window Active -
truewhen currently within the lowest price period of the day - Today Max Price Window Active -
truewhen currently within the highest price period of the day
Based on your configuration settings, these sensors indicate whether you are currently within your configured optimal time windows:
- Today Cheapest Window Active -
truewhen currently within your configured cheapest time window - Today Expensive Window Active -
truewhen currently within your configured most expensive time window
To enable debug logging for the RCE PSE integration, add the following to your Home Assistant configuration.yaml:
logger:
default: info
logs:
custom_components.rce_pse: debugThis will enable detailed logging for:
- Integration setup and configuration
- API requests and responses
- Data fetching and processing
- Sensor creation and updates
- Error handling and troubleshooting
After adding this configuration, restart Home Assistant and check the logs in:
- Configuration > Logs in the Home Assistant UI
- Or directly in the
home-assistant.logfile
Debug logs include:
- PSE API request URLs and parameters
- API response status and data counts
- Configuration flow steps
- Sensor setup progress
- Coordinator data updates
This integration fetches data from the official PSE API:
- API:
https://api.raporty.pse.pl/api- API v2 - Update Interval: 30 minutes
- Data Availability: Tomorrow's prices are available after 14:00 CET
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
Copyright 2025 Lewa-Reka and RCE PSE Integration Contributors
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
Please make sure to update tests as appropriate and ensure your code follows the project's coding standards.