Custom Integration - AU Energy Tariffs and Demand Calculation

Hey everyone :waving_hand:

I’ve built a Home Assistant integration that brings real-time Australian network tariff data into HA. It’s designed for anyone who wants to automate around their electricity pricing. Very useful if you have solar, a battery, or an EV and are on a demand tariff rate.

The integration is agnostic of any Australian electricity retailer (AGL, Origin, Amber etc) so it will work with any retailer as long as you know the energy provider for your region and the official DNSP tariff codes for your plan. More info on tariffs can be found in the tariff service docs → tariff-service/DATA_SOURCES.md at 5f00d64fbb728c79350a76d0e697fae15bd56e41 · Open-Energy-Collective/tariff-service · GitHub

I’m super keen to hear feedback on usability and functionality.

What it does

  • Current rate sensor ($/kWh) updates every 5 minutes based on your actual network tariff schedule
  • Current period sensor tells you if you’re in peak, off-peak, shoulder, or solar soak
  • Demand window sensor binary sensor you can use as an automation trigger (e.g., throttle loads when demand is being measured)
  • Demand charge tracker monitors your grid power and calculates your peak demand + estimated monthly demand charge
  • Config flow UI pick your Network Provider, pick your tariff, done

Supported networks

12 Australian DNSPs: Ausgrid, Endeavour, Essential, Energex, Ergon, AusNet, CitiPower, Powercor, United, Jemena, SA Power Networks, Evoenergy, Power and Water.

Data comes from a free public API: Tariff Data Service - Swagger UI sourced from official AER-approved DNSP Network Price Lists.

Demand tracking

If your tariff has a demand component, the integration automatically:

  • Samples your grid power sensor every 30 seconds
  • Only records during the demand window (correct time, days, and season per your DNSP)
  • Uses the correct measurement method for your network (30-min average, 30-min max, monthly peak, or rolling 12-month max)
  • Persists across restarts
  • Gives you a live $/month demand charge estimate

Great for automations like “pause the EV charger when the demand window opens” or “alert me if my demand charge exceeds $X this month.”

How to install (HACS custom repo)

  1. HACS → Integrations → ⋮ (three dots, top right) → Custom Repositories
  2. URL: https://github.com/Open-Energy-Collective/ha-tariff-au
  3. Category: Integration
  4. Click Add → Install → Restart HA
  5. Settings → Integrations → Add → “OEC Tariff (AU)”

Example automations

# Pause EV charging during demand window
automation:
  - alias: "Pause EV charging during demand window"
    trigger:
      - platform: state
        entity_id: sensor.tariff_energex_3900_demand_window
        to: "Active"
    action:
      - service: switch.turn_off
        target:
          entity_id: switch.ev_charger

Screenshots

1 Like