Compare tariffs on your usage
octopus_compare_tariffsRe-price your half-hourly smart meter readings on other Octopus tariffs and compare unit and standing costs, including VAT, for electricity import/export or gas.
Instructions
Re-price your actual half-hourly smart meter readings on other Octopus tariffs, such as Agile, Go, Cosy, Tracker, Flux or a fixed deal, and compare them with what the tariffs you were on would have cost: unit costs at each tariff's real rate for every half-hour, plus standing charges, including VAT. Give product codes from octopus_list_products (your meter's region and fuel are used) or full tariff codes. Works for electricity import, export (compares earnings) and gas. These are estimates from past usage, which would change if you shifted it to suit a tariff; they ignore eligibility (Go and Intelligent Go need an EV or charger, Cosy a heat pump), exit fees, discounts and credits. Half-hours a tariff has no rate for (for example before a product existed) are left out and counted.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"products": "<products>"
},
"name": "octopus_compare_tariffs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | End: a date (inclusive, the whole day) or date and time (default the end of yesterday) | |
| from | No | Start of the usage to re-price: a date (YYYY-MM-DD, UK time) or date and time (default 30 days ago) | |
| fuel | No | electricity (default) or gas | |
| serial | No | A specific meter serial number (default: the meter point's meter that has readings) | |
| products | Yes | Tariffs to compare, up to 8: product codes like AGILE-24-10-01 or GO-VAR-22-10-14 (from octopus_list_products; the region and fuel come from your meter), or full tariff codes like E-1R-AGILE-24-10-01-C | |
| direction | No | For electricity: import (default, what you use) or export (what you send to the grid, e.g. from solar panels) | |
| gas_units | No | Override the units a gas meter reports in: kwh or m3 (default: as Octopus says for the meter, otherwise m3) | |
| meter_point | No | A specific MPAN (electricity) or MPRN (gas), when the account has several (see octopus_get_account) | |
| account_number | No | Account number like A-1234ABCD (default OCTOPUS_ACCOUNT, or the only account the API key can see) | |
| calorific_value | No | Gas calorific value in MJ/m³ for converting m³ to kWh (default 39.5; your bill shows the actual value) |