get_history
Read-onlyIdempotent
Retrieve long-term energy data from a Panasonic AiSEG2 home energy controller, with selectable time resolution and filters for metrics and circuits, supporting pagination.
Instructions
Read-only. Query the AiSEG2's long-term energy history from its SD-card export (values in Wh).
Requires an SD card inserted in the AiSEG2. The export is downloaded once and cached, so the
first call is slow and later calls are fast. Returns long-form points ({timestamp, metric,
value}); use limit/offset to page (limit caps the number of returned points).
Args:
granularity: Time resolution. "30min"/"hour"/"day" take start/end as YYYY-MM-DD; "month"
takes YYYY-MM; "year" takes YYYY.
start: Range start (inclusive), formatted per the granularity.
end: Range end (inclusive), formatted per the granularity.
metrics: Optional filter by standard series keys (e.g. "generation_pv1", "grid_buy",
"grid_sell", "battery_charge", "battery_discharge", "ev_charge") or their Japanese
header names. Omit for all series.
circuits: Optional filter by circuit name (see list_circuits). Omit for all circuits.
limit: Maximum number of series points to return (default 200).
offset: Number of points to skip (for pagination).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | Yes | ||
| limit | No | ||
| start | Yes | ||
| offset | No | ||
| metrics | No | ||
| circuits | No | ||
| granularity | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| unit | Yes | ||
| series | Yes | ||
| has_more | Yes | ||
| total_rows | Yes | ||
| granularity | Yes | ||
| next_offset | No |