stromnetz-berlin-lastgang

An unofficial asynchronous Python client for historical electricity-consumption data from lastgang-online.stromnetz.berlin.

Features

• Async authentication with automatic retry after portal session expiry.
• Discovery of consumption locations, Zählpunkte, and time series.
• Quarter-hour CSV exports explicitly requested and validated as kWh.
• DST-safe timestamps, including both repeated autumn hours.
• Missing provider intervals preserved as gaps.
• Exact UTC-hour aggregation for statistics-oriented consumers.
• Serialized 31-day exports with configurable request pacing.

The client deliberately uses the portal's CSV export. The chart endpoint rounds values and collapses the repeated hour at the end of daylight-saving time; CSV retains the original precision and all 100 quarter-hours. The client preserves quarter-hour readings and resolves DST by validated row order.

aggregate_hourly() aggregates exactly four consecutive UTC quarters and marks affected hours incomplete when provider intervals are absent.

Installation

python -m pip install stromnetz-berlin-lastgang

Example

from datetime import date

from aiohttp import ClientSession, CookieJar

from stromnetz_berlin_lastgang import Selection, StromnetzBerlinClient


async def read_day(username: str, password: str):
    async with ClientSession(cookie_jar=CookieJar(quote_cookie=False)) as session:
        client = StromnetzBerlinClient(session, username, password)
        location = (await client.get_consumption_locations())[0]
        point = (await client.get_metering_points(location))[0]
        series = point.time_series[0]
        selection = Selection(location, point, series)
        return await client.get_readings(
            selection,
            date(2026, 1, 1),
            date(2026, 1, 1),
        )

Reading.timestamp is the timezone-aware UTC interval end and Reading.value is a Decimal in kWh. Applications should let users choose a location, Zählpunkt, and compatible consumption series instead of silently selecting the first catalog entries as the short example does.

Development

Python 3.12 or newer is required.

python3 -m venv .venv
.venv/bin/python -m pip install --editable '.[test]'
.venv/bin/python -m pytest
.venv/bin/python -m ruff check src tests tools

Never add portal credentials, cookies, CSRF tokens, addresses, Zählpunkte, or raw consumption exports to fixtures, logs, or commits.

Home Assistant

The companion Home Assistant integration is maintained separately at ress/home-assistant-stromnetz-berlin-lastgang.

Security and privacy

The client accepts credentials only at runtime and never intentionally logs them. Applications remain responsible for protecting credential storage and consumption data.

See the architecture notes for the protocol and data model.

Released under the MIT License.