Time of Use (Peak/Mid-Peak/Off-Peak) cost breakdown in the Energy dashboard from the Opower API — SMUD, PG&E, and friends

[Borillion]

Integration name

Opower

Link to integration documentation on our website

https://www.home-assistant.io/integrations/opower/

Describe the enhancement

Today the Opower integration imports total consumption and cost only, so on a time-of-use (TOU) or tiered rate the Energy dashboard can't show which portion of usage and money went to each rate period. On those plans that's the number that actually matters, and every utility shows it on its own billing site.

It turns out the Opower API already returns the per-period breakdown in the same cost responses the integration fetches today: a readComponents[] array with per-TOU-period (dayPart) or per-tier (tierType/tierNumber) kWh and cost, at both daily and hourly resolution. The integration's library just doesn't parse it. No new API requests are needed.

The enhancement: parse that field and have the integration create per-rate-period statistics (e.g. Peak / Mid-Peak / Off-Peak energy and cost) alongside the existing totals. Users could then add them as grid sources in the Energy dashboard for a full breakdown. No config changes required; the extra statistics would simply be available.

Here's a proof of concept with the parsed data feeding a real Energy dashboard (a real day from my SMUD meter; the Peak band appears only 5 to 8 PM, matching the rate schedule.

Use cases

• On TOU rates the price spread is large. My SMUD plan is $0.3765/kWh Peak, $0.2139 Mid-Peak, $0.1550 Off-Peak. Seeing the split is how you evaluate load-shifting: in my July data, Peak hours were only 11% of my energy but 20% of my bill.
• Reproduces what every Opower utility (SMUD, PG&E, ConEd, Duke, Exelon utilities, ~40 others) already shows on their own billing portals, but in Home Assistant, next to the rest of your energy data.
• The same field covers tiered rates via tierType/tierNumber, so tiered-rate users get their breakdown too.
• Verified against live SMUD data: per-period values sum exactly to the read totals, and each period's cost/kWh reproduces the published rates.

Anything else?

Implementation is staged:

• Library change (parse readComponents): submitted as Parse readComponents (TOU / tier cost breakdown) from cost reads tronikos/opower#208, investigation in Expose Time of Use / Tier cost breakdown ( readComponents ) already present in cost reads tronikos/opower#207. Purely additive; the new field defaults to empty, so nothing changes for existing consumers.
• Once that merges and a release is cut, a follow-up PR to the core Opower integration can create the per-period statistics using the coordinator's existing statistics machinery.

[github-actions[bot]]

🏷️ I've automatically added the integration: opower label to help categorize this feature request.

[jmartin235-rgb]

This is a great addition! We have PECO which has Opower and on their TOU plan, so this will be great enhancement.