Unit rates
octopus_get_unit_ratesFetch pence-per-kWh unit rates for a tariff over a date range, including Agile half-hourly and Go cheap/peak prices, plus current price, next change, and min/max/average.
Instructions
Get a tariff's unit rates (pence per kWh, including VAT) over a period: every half-hour for Agile, the cheap and peak periods for Go, Intelligent Go, Cosy and Flux, daily prices for Tracker, and the flat rate for fixed and flexible tariffs. Also gives the price now, when it next changes, and the minimum, maximum and average. Choose the tariff by tariff_code, by product_code with region or postcode, or leave them out for the account's current tariff. Day/night tariffs list day and night rates separately.
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_get_unit_rates"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | End: a date (inclusive, the whole day), a date and time, or today/tomorrow (default the end of tomorrow; Agile prices for tomorrow are usually published around 4pm) | |
| from | No | Start: a date (YYYY-MM-DD, UK time), a date and time, or now/today/tomorrow (default the start of today) | |
| fuel | No | electricity (default) or gas | |
| limit | No | Return at most this many rates (default 200) | |
| 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) |