Skip to content

Electricity Providers

bolagnaise edited this page Mar 1, 2026 · 27 revisions

Electricity Providers

Supported Providers

Provider Country Pricing Type API Auth Required
Amber Electric Australia Dynamic 5-min & 30-min API Token
Localvolts Australia Dynamic 5-min (real-time wholesale) API Key + Partner ID
Flow Power Australia AEMO Wholesale No
Globird / AEMO VPP Australia Static + Spike Detection No
Octopus Energy UK Dynamic 30-min No (public API)
NZ TOU New Zealand Static TOU (3-tier) No

Amber Electric (Australia)

Dynamic pricing with 5-minute and 30-minute resolution. Current prices update every 5 minutes; forecasts are available at 30-minute resolution.

Setup:

  1. Get an API token from app.amber.com.au/developers
  2. Select Amber Electric during PowerSync setup
  3. Enter your API token
  4. Select your Amber site

Localvolts (Australia)

Real-time wholesale pricing with native 5-minute NEM interval resolution. Localvolts provides marginal import and export prices (costsFlexUp / earningsFlexUp) with up to 24 hours of forward forecast data.

Setup:

  1. Obtain your API Key and Partner ID from Localvolts
  2. Select Localvolts during PowerSync setup
  3. Enter your API Key, Partner ID, and NMI (National Meter Identifier)
  4. Configure export boost and chip mode settings (optional)

Configuration

Option Description
API Key Your Localvolts API key (keep this secret)
Partner ID Your Localvolts Partner ID
NMI Your 10-digit National Meter Identifier. Use * for all authorized NMIs.

How It Works

  • Prices are fetched every 5 minutes from the Localvolts API
  • Import prices come from the costsFlexUp field (c/kWh)
  • Export prices come from the earningsFlexUp field (c/kWh)
  • Data is converted to Amber-compatible format internally, so all features work seamlessly:
    • Smart Optimization (LP optimizer) with native 5-min resolution
    • TOU tariff sync to Tesla/Sigenergy/FoxESS/GoodWe/Sungrow
    • Battery export curtailment at negative prices
    • Export boost and chip mode
  • Forward forecast is limited to ~24 hours (the LP optimizer pads beyond this with the last known price)
  • AEMO spike detection can be configured independently for price spike exports

Notes

  • Localvolts does not provide Amber's spikeStatus field. If you want automatic battery discharge during NEM price spikes, enable the AEMO Spike Detection feature separately.
  • 'N/A' values in the API response (e.g. when no imports/exports in a forecast period) are treated as 0.0 c/kWh.

Flow Power / AEMO (Australia)

Uses AEMO wholesale pricing directly — no API token required. Prices update every 5 minutes from the AEMO NEM dispatch feed. You can optionally provide an Amber API token as an alternative price source.

Price Sources

Source Description
AEMO Direct (default) Fetches wholesale prices directly from AEMO NEMWeb. No API key needed.
Amber API Uses your Amber Electric API token for pricing data. Useful if you also have an Amber account.

PEA (Price Efficiency Adjustment)

Flow Power bills using: Final Rate = Base Rate + PEA

PEA adjusts your rate based on when you consume relative to wholesale prices:

  • Cheap wholesale (e.g. midday solar) → negative PEA → you pay less than the base rate
  • Average wholesale → PEA near zero → you pay roughly the base rate
  • Expensive wholesale (e.g. evening peak) → positive PEA → you pay more than the base rate

The PEA formula is: PEA = wholesale - TWAP - 1.7

Where:

  • TWAP is the 30-day rolling Time Weighted Average Price (the market average)
  • 1.7 c/kWh is the BPEA (Benchmark Performance Efficiency Adjustment)

PowerSync calculates the TWAP dynamically from actual wholesale prices. On a fresh install, it falls back to 8.0 c/kWh until enough data is collected (~1 hour / 12 samples).

Sensors

Sensor Description
Flow Power Import Price Current import rate in $/kWh (Base Rate + PEA)
Flow Power Export Price Current export rate — Happy Hour rate during 5:30-7:30pm, 0 otherwise
Flow Power TWAP 30-Day Average Rolling 30-day market average in c/kWh used in PEA calculation

The TWAP sensor includes attributes: days_of_data, sample_count, using_fallback, and twap_dollars.

Configuration Options

Option Description Default
NEM Region Your grid region (NSW1, QLD1, VIC1, SA1, TAS1) NSW1
Base Rate Your Flow Power base rate in c/kWh (from your plan) 34.0
PEA Enabled Enable PEA pricing adjustment Yes
Custom PEA Override the calculated PEA with a fixed value from your bill Auto

Globird / AEMO VPP (Australia)

Static pricing with AEMO spike detection for VPP participation. No API token required. See Advanced Features for details on automatic discharge during price spikes.

GloBird Provider Settings


New Zealand TOU

Static time-of-use pricing for NZ electricity retailers. No API token required — rates are entered during setup from your plan details. All rates in NZD cents per kWh.

NZ TOU pricing follows the Electricity Authority's mandated TOU structure: 3-tier pricing (Peak, Shoulder, Off-Peak) with weekday-only peaks and weekends typically off-peak or shoulder.

Supported Retailers

Retailer Plan Key Feature
Octopus Energy NZ Standard TOU 3-tier peak/shoulder/off-peak with TOU export rates
Electric Kiwi Standard TOU 3-tier pricing (Hour of Power selected via Electric Kiwi app)
Contact Energy Good Weekends Free electricity on weekends
Contact Energy Good Nights Free electricity 9pm-midnight every night
Contact Energy Good Charge EV-focused with cheap overnight rate
Custom NZ TOU Any plan Enter your own rates for any NZ retailer

TOU Periods

Standard NZ TOU periods (used by most retailers):

Period Weekdays Weekends
Peak 7-9am, 5-9pm
Shoulder 9am-5pm 7am-9pm
Off-Peak 9pm-7am 9pm-7am

Configuration

  1. Select New Zealand TOU as your electricity provider
  2. Choose your retailer (or Custom for any NZ plan)
  3. Select your distribution zone (Vector, Wellington, Orion, Powerco, Unison, Aurora, or Other)
  4. Review and adjust the pre-filled rates for your plan (or enter rates manually for Custom)
    • Peak, Shoulder, Off-Peak import rates (NZD c/kWh)
    • Peak and Off-Peak export rates (NZD c/kWh)
    • Daily supply charge (NZD c/day)

Distribution Zones

Zone Region
Vector Auckland
Wellington Electricity Wellington
Orion Canterbury
Powerco Waikato / Taranaki / Manawatu
Unison Hawke's Bay / Rotorua / Taupo
Aurora Otago / Southland
Other Any other network area

How It Works

  • Rates are stored as a TOU tariff schedule — the same format used by all other providers
  • The LP optimizer uses your TOU rates to calculate optimal charge/discharge schedules, with weekday-only peaks handled automatically
  • If you have a Tesla Powerwall, the TOU schedule is synced to the Powerwall for native tariff-aware behaviour
  • Rates can be updated anytime via the integration options flow (Settings > Devices & Services > PowerSync > Configure)

Notes

  • Electric Kiwi Hour of Power is not modelled in the TOU schedule — select your free hour via the Electric Kiwi app as usual
  • Contact Good Weekends uses a 0 c/kWh rate for all weekend hours — the optimizer will prefer weekend consumption
  • Contact Good Nights uses a 0 c/kWh rate for 9pm-midnight — the optimizer may shift load to this window
  • Template rates are approximate starting points — always verify against your actual plan rates

Octopus Energy (UK)

Full support for UK users with Octopus Energy dynamic tariffs. No API token required — uses the public Octopus pricing API.

Supported Products

Product Description
Agile Octopus Dynamic half-hourly pricing based on wholesale rates
Octopus Go EV tariff with cheap overnight rates (00:30-05:30)
Octopus Flux Solar/battery optimized import/export tariff
Octopus Tracker Daily wholesale price tracking

Features

  • Half-hourly pricing (same 30-minute resolution as Amber)
  • Automatic TOU sync to Tesla/Sigenergy
  • Regional pricing via GSP (Grid Supply Point) selection
  • Negative price handling
  • Export rates (Agile Outgoing and Flux)

Configuration

  1. Select Octopus Energy (UK) as your electricity provider
  2. Choose your product (Agile, Go, Flux, Tracker)
  3. Select your GSP region (A-P) — find this on your Octopus bill

GSP Regions

Code Region
A Eastern England
B East Midlands
C London
D Merseyside and North Wales
E Midlands
F North Eastern
G North Western
H Southern
J South Eastern
K South Wales
L South Western
M Yorkshire
N South Scotland
P North Scotland

Clone this wiki locally