Track fixed electricity price offerings (hintakiinnitykset) from Finnish providers over time. Currently supports Lumme Energia and PKS (Pohjois-Karjalan Sähkö).
Prices are fetched daily from each provider's public API, stored in a SQLite database, and published as an interactive HTML report.
Finnish electricity providers offer quarterly fixed-price contracts whose prices change daily based on market conditions. This tool:
- Fetches all currently available fixed price offerings from Lumme Energia and PKS
- Stores one snapshot per offer per day per provider in a SQLite database
- Generates a self-contained HTML report with:
- Summary table of current prices from all providers
- Interactive line chart showing how offered prices have changed over time
- Provider toggle to filter by Lumme, PKS, or both
Requires Python 3.12+ and uv.
# Show current prices from all providers
uv run -m hintakiinnitys
# Fetch prices and store to database
uv run -m hintakiinnitys store
# Generate HTML report from stored data
uv run -m hintakiinnitys report > report.html
# Backfill PKS historical prices
uv run -m hintakiinnitys backfill-pksA GitHub Actions workflow runs daily:
- Fetches the latest prices from both providers and stores them in
prices.db - Commits the updated database to the repository
- Generates the HTML report and deploys it to GitHub Pages
The workflow can also be triggered manually from the Actions tab.
src/hintakiinnitys/
__main__.py CLI entry point
client.py Lumme Energia API client
pks_client.py PKS API client
db.py SQLite storage
models.py Data models
report.py HTML report generator with interactive charts
Use of this software is at your own risk. Nobody assumes liability for any consequences. If this program accidentally cuts your house's electricity, consider it a stroke of luck that it didn't affect everyone else's electricity as well.
This project is not affiliated with Lumme Energia or PKS. Price data is sourced from their publicly accessible APIs.