Get accumulated energy
get_energyCalculate accurate energy consumption or generation in watt-hours between two dates from meter readings, ideal for reporting and billing queries.
Instructions
Get true accumulated energy (watt-hours) between two dates from meter readings, rather than averaging instantaneous power. Use this for 'how much did this site generate' questions, and for anything reporting- or billing-shaped, because averaging watts loses accuracy on accumulating properties.
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": {
"nodeIds": "<nodeIds>",
"localStartDate": "<localStartDate>",
"localEndDate": "<localEndDate>"
},
"name": "get_energy"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nodeIds | Yes | Node IDs | |
| sourceIds | No | Restrict to these source IDs; omit for all sources | |
| readingType | No | Difference is the usual choice for energy over a period | Difference |
| localEndDate | Yes | Exclusive end in node-local time, YYYY-MM-DDTHH:mm | |
| localStartDate | Yes | Inclusive start in node-local time, YYYY-MM-DDTHH:mm |