Repository navigation
Provider Octopus
All providers · Tariff periods · Configuration index
Choose this provider during initial setup, or open Settings > Devices & Services > PowerSync > Configure > Electricity pricing & provider to change its settings. Use the written plan for your site and account; examples are not a substitute for your contract.
Full support for UK users with Octopus Energy dynamic tariffs.
| Product | Description |
|---|---|
| Agile Octopus | Dynamic half-hourly pricing based on wholesale rates |
| Octopus Go | EV tariff with cheap overnight rates (00:30-05:30) |
| Intelligent Octopus Go | Smart EV/battery tariff with dispatch-aware off-peak |
| Octopus Flux | Solar/battery optimized import/export tariff |
| Intelligent Octopus Flux | Smart battery optimized tariff |
| Octopus Tracker | Daily wholesale price tracking |
- Half-hourly pricing
- Automatic tariff refresh for PowerSync display and optimization. Tesla sites can upload the TOU schedule to the Powerwall; Modbus systems use the tariff data inside PowerSync
- Regional pricing via GSP (Grid Supply Point) selection
- Negative price handling
- Export rates: auto-discovered from your Octopus account, or uses Outgoing Octopus as default
- BottlecapDave integration bridge (v2.4.1+): When HomeAssistant-OctopusEnergy is installed, PowerSync reads rates directly from it — avoiding double API calls and getting your actual export tariff automatically
- Saving Sessions auto-join (v2.4.6+): Works with both Direct API mode and BottlecapDave's integration
- Saving Session sensors expose whether an event is active, the next known session, and the converted reward rate.
- Select Octopus Energy (UK) as your electricity provider
- Choose your product (Agile, Go, Intelligent Go, Flux, Tracker)
- Select your GSP region (A-P) — find this on your Octopus bill
- (Optional) Configure Saving Sessions — choose Direct or Entity (Dave's integration) as source
Saving Sessions can be configured after the main Octopus tariff under Configure > Electricity pricing & provider > Octopus Saving Sessions.
| Source | Required Details | Notes |
|---|---|---|
| Direct API | Octopus API key and account number | Lets PowerSync read sessions directly and auto-join when enabled |
| Entity source | BottlecapDave/HomeAssistant-OctopusEnergy saving-session entity | Use this when that integration already tracks your sessions |
When enabled, PowerSync creates Saving Session sensors and treats joined saving-session windows as allowed export opportunities for Smart Optimization. Auto-join is optional. Reward rates are converted from Octopoints using the configured Octopoints-per-penny value.
| 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 |
Check the current import/export price and tariff schedule for the selected site and local time. On a menu-entered edit, saving provider settings can finish the flow directly; specialist settings remain under Advanced settings. Token/account success, an imported schedule and a hardware command are different outcomes. If rates or the site are wrong, reopen pricing rather than changing battery connection settings.
The tables use the current form labels and help text. They list the conditional field union: a field can be hidden for a different battery, provider, route or available integration. The instructions above explain those conditions. Existing saved/discovered values take precedence over fresh fallbacks. Rate units follow the provider; check the displayed currency/energy unit.
| Field | Meaning / input | Fallback / limits |
|---|---|---|
| Octopus product | Agile = half-hourly dynamic. Go/Intelligent Go = cheap overnight EV rates. Flux/Intelligent Flux = solar+battery optimised. Tracker = daily wholesale. | Fallback agile |
| GSP region | Your Grid Supply Point region (single letter A-P). Check your Octopus bill or account dashboard. | Fallback C |
| Field | Meaning / input | Fallback / limits |
|---|---|---|
| Octopus product | Agile = half-hourly dynamic. Go/Intelligent Go = cheap overnight EV rates. Flux/Intelligent Flux = solar+battery optimised. Tracker = daily wholesale. | Saved/detected value or the form’s shown fallback |
| GSP region | Your Grid Supply Point region (single letter A-P). Check your Octopus bill or account dashboard. | Saved/detected value or the form’s shown fallback |
| Enable automatic TOU sync | Automatically upload TOU tariff schedules to your battery based on current prices. | Saved/detected value or the form’s shown fallback |
| Stop export below threshold | Stop battery from exporting when export earnings drop below the configured threshold. | Saved/detected value or the form’s shown fallback |
| Field | Meaning / input | Fallback / limits |
|---|---|---|
| Enable saving sessions | Enable automatic battery export during Octopus Saving Sessions. | Saved/detected value or the form’s shown fallback |
| Data source | Direct uses the Octopus GraphQL API (requires API key). Entity reads from Bottlecap Dave's Octopus integration. | Saved/detected value or the form’s shown fallback |
| Octopus API key | Your Octopus API key from the developer dashboard (not the same as your public tariff API key). | Saved/detected value or the form’s shown fallback |
| Account number | Your Octopus account number (e.g. A-12345678). | Saved/detected value or the form’s shown fallback |
| Bottlecap Dave entity ID | Entity ID of the Bottlecap Dave saving sessions event entity (e.g. event.octopus_energy_saving_sessions). | Saved/detected value or the form’s shown fallback |
| Auto-join available sessions | Automatically join available saving sessions. Only works in direct mode. | Saved/detected value or the form’s shown fallback |