wiener-netze-smart-meter-api 0.1.4

A Python wrapper for the official Wiener Netze Smart Meter API (WN_SMART_METER_API)

Wiener Netze Smart Meter API

---

Table of Contents

• Introduction
• First Steps
• Installation
• Usage
• License

Introduction

This project provides a Python wrapper for the official Wiener Netze Smart Meter API (WN_SMART_METER_API), which is published by Wiener Stadtwerke through their developer portal. Unlike other approaches (notably fleinze’s vienna-smartmeter API Python wrapper and DarwinsBuddy’s HomeAssistant Integration) that rely on web-login recreation and can fail due to captchas, rate limiting, or other website changes, this wrapper uses the official endpoint.

By following the instructions below, you can acquire the necessary API credentials (client ID, client secret, and API key) from Wiener Stadtwerke’s developer portal and start fetching your power usage data .

First Steps

1. Create an account at the Developer Portal of the Wiener Stadtwerke
2. Create an application here for the WN_SMART_METER_API
3. When the application is approved you will get an e-mail from API Developer Portal. The API-key is then found in the details of the newly created application.
4. Write an e-mail to the Smart Meter Portal Support to connect the application with the Smart Meter Portal user. It usually takes 1-2 weeks to get a response.
5. Afterwards the client-ID and client-secret can be found in the settings of the Smart Meter-Businessportal.

Installation

pip install wiener-netze-smart-meter-api

Updating

pip install -U wiener-netze-smart-meter-api

Usage

from wiener_netze_smart_meter_api import WNAPIClient
from datetime import datetime

client = WNAPIClient(client_id="client-id", client_secret="client-secret", api_key="API-key")

# Fetch all smart meters
smart_meters = client.get_anlagendaten()
print("All Smart Meters:", smart_meters)

# Fetch specific smart meter details
smart_meter_number = "AT0010000000000000001000000000000"
specific_meter = client.get_anlagendaten(smart_meter_number)
print("Specific Smart Meter:", specific_meter)

# Fetch quarter-hourly measured values for all meters for the last 3 years (default time period)
quarter_hour_values = client.get_quarter_hour_values()
print("Quarter-Hourly Values:", quarter_hour_values)

# Fetch daily measured values for a specific meter for the last 3 years (default time period)
daily_values = client.get_daily_values(smart_meter_number)
print("Daily Values for Specific Meter:", daily_values)

# Fetch daily measured values for a specific meter for the last 3 years (default time period) with pagination in 30 days chunks (default chunk size)
daily_values_paginated = client.get_daily_values(smart_meter_number, paginate=True)
print("Daily Values for Specific Meter with Pagination:", daily_values_paginated)

# Fetch meter readings for a specific meter for a specific time period
meter_readings = client.get_meter_readings(smart_meter_number, "2025-01-01", "2025-01-02")
print("Meter Readings:", meter_readings)

# Fetch meter readings for a specific meter for a specific time period with pagination in 7 days chunks
meter_readings_paginated = client.get_meter_readings(smart_meter_number, "2025-01-01", "2025-01-31", paginate=True, chunk_days=7)
print("Meter Readings Paginated:", meter_readings_paginated)

# Optional settings for the client regarding request retries, delay and timeout.
client = WNAPIClient(
    client_id="client_id",
    client_secret="",
    api_key="api_key",
    max_retries=3,
    retry_delay=5,
    timeout=10,
)

License

wiener-netze-smart-meter-api is distributed under the terms of the MIT license.