Find the cheapest times
octopus_find_cheapest_slotsLocate low-cost continuous electricity-use blocks and individual half-hours on Octopus time-of-use tariffs, such as Agile, to schedule appliances, batteries, or EV charging.
Instructions
Find the cheapest time to use electricity on a time-of-use tariff such as Agile: the cheapest continuous block of a given length (for a dishwasher, washing machine, battery or car), runner-up blocks that don't overlap, and the cheapest individual half-hours. Only looks at prices Octopus has published (Agile prices for the next day usually appear around 4pm). Choose the tariff by tariff_code, by product_code with region or postcode, or leave them out for the account's current tariff.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "octopus_find_cheapest_slots"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Latest end: a date and time, or a date (inclusive; default as far ahead as prices are published) | |
| kwh | No | Energy the job will use, in kWh (for example 7 for a dishwasher and washing machine), to estimate its cost in the best block | |
| from | No | Earliest start: a date and time, or now (default now) | |
| fuel | No | electricity (default) or gas | |
| slots | No | Also list this many of the cheapest individual half-hours, which need not be together (default 6; 0 for none) | |
| region | No | With product_code: the region letter A to P (see octopus_find_region) | |
| postcode | No | With product_code, instead of region: a UK postcode, used to look up the region | |
| direction | No | With the account's tariff: import (default) or export | |
| tariff_code | No | A tariff code like E-1R-AGILE-24-10-01-C (from octopus_get_product or octopus_get_account) | |
| product_code | No | Instead of tariff_code: a product code like AGILE-24-10-01 (see octopus_list_products), with region or postcode | |
| account_number | No | With none of the above, the account's current tariff is used: account number like A-1234ABCD (default OCTOPUS_ACCOUNT or the only account) | |
| duration_hours | No | Length of the continuous block to find, in hours, in steps of 0.5 (default 2) |