wiener-netze-smart-meter-api 0.0.6

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 released you will get an e-mail from API Developer Portal that the application is approved. The API-key is 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

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
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
daily_values = client.get_daily_values(smart_meter_number)
print("Daily Values for Specific Meter:", daily_values)

# Fetch meter readings for a specific meter for specific days
meter_readings = client.get_meter_readings(smart_meter_number,datetime(2025,1,1).strftime('%Y-%m-%d'),datetime(2025,1,2).strftime('%Y-%m-%d'))
print("Meter Readings:", meter_readings)

License

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