Home battery plan
plan_home_batteryA home battery's plan from the half hour under way to the end of tomorrow, on the tariff's real prices (Agile's, and Agile Outgoing's, estimated beyond what Octopus has published), half hour by half hour: charge from the grid, hold, run the house (self-use), export, or send the sun to the grid – the cheapest way through, counting the battery's losses and wear. Exporting follows what the export tariff pays for – everything on Octopus's, only what the panels put in on the others – unless battery_export=all says the home is paid for what the battery charged from the grid too. A battery without panels gives export (Octopus's outgoing, agile-outgoing or prime-outgoing, eon-next-export-premium for a battery E.ON fitted, or fixed with export_rate) and trades on the grid: charging cheap, exporting at the peak. Smart Export Guarantee tariffs pay only for what panels made, so not a battery on its own. now is what to set this half hour; settings the few changes worth typing into the inverter's app. For a typical home of usage; give soc (the battery's charge now) for a plan from where it is. Advice and data for the owner's own automation – Renewably never controls a battery.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| soc | No | The battery's charge now, per cent (0-100). Default: at its reserve. | |
| rate | No | Charge and discharge rate, kW (0.5-15, default 3). | |
| wear | No | The battery's wear for each kWh it gives back, pence (0-20, default 2). | |
| usage | No | The home's electricity use, kWh a year (500-30000, default 2500). | |
| export | No | How export is paid: `paired` (the tariff's own export tariff, default), `fixed` (with export_rate), `fit` (the Feed-in Tariff's deemed export: paid whatever is exported, so the sun used at home gives nothing up), `none`, or an export tariff's key from list_tariffs?direction=export (used where the tariff can have it, else its own). | |
| region | Yes | Agile region: a letter A-P or the slug from list_regions (eg `C` or `london`); list_regions lists well-known places in each. | |
| tariff | No | A tariff's key from list_tariffs (default `agile`), eg `go`, `edf-go-electric`, `eon-next-drive`. | agile |
| battery | No | Usable battery, kWh (2-50, default 10). | |
| ceiling | No | Never charged above this, per cent (10-100, default 100; above `reserve`) – for an inverter set to stop short of full. | |
| reserve | No | Never below this, per cent (0-90, default 0). | |
| solar_kwp | No | The home's solar panels, kWp (0.2-50): the answer then counts their forecast spare sun – see the docs' Solar panels section. | |
| round_trip | No | Round-trip efficiency, per cent (60-100, default 90). | |
| export_rate | No | A fixed export rate, p/kWh (0-100). | |
| solar_pitch | No | Their angle from flat, degrees (0-90, default 35). | |
| export_limit | No | The home's export limit, kW (0-30, default 3.68: a G98 connection). | |
| solar_facing | No | The way they face: S, SE, SW, E, W, NE, NW or N – or a bearing in degrees (south is 180). Default S. | |
| grid_charging | No | `1` (default) may charge from the grid; `0` only from the panels. | 1 |
| battery_export | No | What the battery may export: `terms` (default) what the export terms pay for – on Octopus's export tariffs everything, on the others only what the panels put in; without panels everything, once `export` is given; `all` what it charged from the grid too, on any export tariff – check the supplier pays for that; `solar` only what the panels put in, even on Octopus's; `never`. | terms |
| solar_inverter_kw | No | The inverter's limit, kW (0.5-50), if smaller than the panels. |