Live electricity demand
octopus_get_live_usageRetrieve near real-time electricity readings from an Octopus Home Mini smart meter, including current demand in watts and energy used per interval; requires a paired Home Mini.
Instructions
Get near real-time electricity readings from the smart meter through an Octopus Home Mini: current demand in watts and energy used in each interval. Needs a Home Mini paired with the smart meter; without one this returns no data. Readings are typically a few seconds to a few minutes old.
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_live_usage"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hours | No | How far back to look, in hours; fractions allowed, for example 0.25 for 15 minutes (default 1, at most 24) | |
| limit | No | Return at most this many readings, the most recent (default 60) | |
| grouping | No | Reading interval: TEN_SECONDS, ONE_MINUTE, FIVE_MINUTES, HALF_HOURLY or HOURLY (default ONE_MINUTE up to an hour, FIVE_MINUTES beyond) | |
| device_id | No | Smart meter device ID (default: the electricity import meter's, from octopus_get_account) | |
| account_number | No | Account number like A-1234ABCD (default OCTOPUS_ACCOUNT, or the only account the API key can see) |