Octopus Energy

Getting Started

Connect your Octopus Energy tariff so Joule Genie can fetch your half-hourly import and export rates and optimise battery charging around them automatically.

Step 1: Find Your API Key

Log in to the Octopus Energy dashboard at octopus.energy. Click your name in the top-right corner and go to Account. Scroll down to Developer Settings. Your personal API key is shown there — it starts with sk_live_. Copy it. If you do not see a Developer Settings section, check that you are logged in to the account that holds your energy supply (not a sub-account).

Step 2: Add the Integration in Joule Genie

In Joule Genie, go to Settings > Integrations > Add Integration and select Octopus Energy from the Tariff category. Paste your API key into the field and click Discover my account. Joule Genie will connect to the Octopus API and automatically discover your account number, meter points, and active tariff code — no MPAN or meter serial needed.

Step 3: Select Your Meter Point

If you have multiple meter points (e.g. import and export), Joule Genie will list them. Select the import meter point for the tariff you want to use for optimisation. The tariff type and tariff code are shown to help you identify the correct one.

Step 4: Verify Rates

After saving, go to the Dashboard → Rates section. You should see today's half-hourly rates for your tariff. For Agile tariffs, tomorrow's rates typically appear after 4pm.

Supported Tariffs

• Octopus Agile — variable half-hourly rates that change every 30 minutes. Full rate awareness and schedule optimisation supported.
• Octopus Go / Go Faster — off-peak overnight rate. Joule Genie schedules battery charging into the cheap overnight window.
• Intelligent Octopus — similar to Go; Joule Genie works with the fixed off-peak periods.
• Octopus Cosy and other variable-rate products — supported via automatic tariff code detection.
• Fixed-rate tariffs — import rate is applied as a flat cost for savings calculations.

Automatic Tariff Refresh

Octopus periodically releases new product versions (e.g. Agile-24-10-01 → Agile-25-04-01). Joule Genie automatically detects when your tariff code has expired and switches to the current version — you do not need to update the integration manually when Octopus rolls out a new product.

Troubleshooting

• API key not found? Ensure you are logged in to octopus.energy and navigate to Account → Developer Settings. If you have multiple Octopus accounts, make sure you are using the one linked to your electricity supply.
• No meter points discovered? Your account must have an active electricity supply registered. If you have recently switched to Octopus, the supply may still be in the process of being transferred — try again after a few days.
• Rates not updating? For Agile, tomorrow's rates are usually published by Octopus around 4pm. If you are not seeing them, rates may be delayed — this is normal and they will appear once Octopus publishes them.
• "Invalid API key" error? Double-check the key starts with sk_live_ and was copied without extra spaces.

Vendor documentation

For account or device details from the manufacturer, see the official Octopus Energy documentation.