energyzero

What it is and what it does

EnergyZero is an async Python client that fetches real-time and day-ahead electricity and gas prices from the EnergyZero API, which also serves third-party energy retailers. It supports two backends: a REST API for single-date queries (hourly or quarter-hour electricity, daily gas) and a GraphQL endpoint for multi-day ranges with extended metadata. Prices are returned in EUR/kWh for electricity and EUR/m³ for gas, with support for multiple price types (market, market-with-VAT, all-in excluding VAT, all-in including VAT). The client provides convenience methods to extract current prices, averages, extremes, and price lookups at specific timestamps, making it straightforward to integrate energy pricing into home automation, billing systems, or energy-optimization applications.

The package requires Python 3.12 or later and depends on aiohttp for HTTP requests and yarl for URL handling. It is actively maintained, has no known security vulnerabilities, and is classified as production-stable. The API is designed around async/await patterns, so it integrates naturally with asyncio-based applications.

Use it for

• Fetch today's and tomorrow's electricity prices to display in a home energy dashboard or automation system.
• Retrieve gas prices for billing reconciliation or cost forecasting across multiple days.
• Build price-aware scheduling logic that shifts energy consumption to cheaper hours or quarter-hour windows.
• Integrate with third-party energy providers (ANWB Energie, Energie van Ons, etc.) that use EnergyZero's pricing.
• Monitor extreme prices and alert users when electricity or gas rates exceed a threshold.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

energyzero on PyPI

Before you install

Low install friction with a pure-Python wheel and only two runtime dependencies (aiohttp, yarl). Repository is actively maintained with recent commits and no known vulnerabilities.

Requires Python 3.12 or later; aiohttp and yarl must be installed (handled by pip automatically).

License in practice

MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for commercial and private projects.

Quickstart

import asyncio
from datetime import datetime
from zoneinfo import ZoneInfo
from energyzero import EnergyZero, Interval, PriceType

async def main():
    async with EnergyZero() as client:
        local_tz = ZoneInfo("Europe/Amsterdam")
        today = datetime.now(local_tz).date()
        prices = await client.get_electricity_prices(
            start_date=today,
            interval=Interval.QUARTER,
            price_type=PriceType.ALL_IN,
            local_tz=local_tz,
        )
        print(prices.average_price)

asyncio.run(main())

Package facts

Evidence: energyzero-5.0.2-py3-none-any.whl

Tags

More Python Modules packages

See also amberelectric · electrickiwi-api · forecast-solar · gridstatus · p1monitor · entsoe-py · pyTibber · pysmartthings · opower · energyquantified