Amber Electric

Amber is an Australian electricity retailer that provides access to wholesale electricity prices. Customers monitor the wholesale price and shift their energy usage to cheaper, greener times. This saves them money and supports Australia’s shift towards more renewable energy. Customers can also sell their unused electricity for fluctuating prices. This differs from other wholesale providers, where selling prices vary based on grid demand.

Using the Amber Electric integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more], customers can go a step further - setting up devices to automatically shift energy usage to cheaper and greener times, based on real-time electricity prices and forecasts

Getting an API Key

To use this integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more], you will need to generate an API key.

  1. Log in to your Amber account
  2. Click Settings
  3. Enable Developer Mode
  4. Click Generate API Key
  5. Give your API Key a memorable name (say, Home Assistant)
  6. Copy the code that is generated. Note: It will disappear after you reload the page, so make sure you make note of it!

Configuration

To add the Amber Electric service to your Home Assistant instance, use this My button:

Manual configuration steps

If the above My button doesn’t work, you can also perform the following steps manually:

  • Browse to your Home Assistant instance.

  • Go to Settings > Devices & services.

  • In the bottom right corner, select the Add Integration button.

  • From the list, select Amber Electric.

  • Follow the instructions on screen to complete the setup.

How the integration works

Prices are split up into three channel types:

  • General - This is the channel that records all your power usage from your lights and appliances
  • Controlled Load - A special channel that is only activated during off-peak times. Often electric hot water systems are connected to the controlled load channel.
  • Feed In - A channel that records exported power from solar panels and batteries.

It exposes the following sensorsSensors return information about a thing, for instance the level of water in a tank. [Learn more] for each channel type:

  • Price - Your current electricity price in $/kWh
  • Forecast - The forecasted prices for the next 12 hours
  • Descriptor - A description of the price. Useful if you want to create an Amber light that matches the app. Possible values: extremely_low, very_low, low, neutral, high, and spike.

There are two additional sensors:

  • Price Spike - A binary sensor that indicates when the current price is over $3/kWh.
  • Renewables - The percentage of renewable energy currently in the grid.

List of actions

The Amber Electric integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides the following actions. Each link below opens a dedicated page with examples, parameters, and a step-by-step UI walkthrough.

  • Get price forecasts (amberelectric.get_forecasts) Retrieves price forecasts from Amber Electric for a site and channel.

For an overview of every action across all integrations, see the actions reference.