get_cost_history
Read-onlyIdempotent
Query long-term energy-cost history from an AiSEG2 SD card, returning cost points in Japanese yen. Filter by day, month, or year granularity.
Instructions
Read-only. Query the AiSEG2's long-term energy-cost history from the SD-card export (JPY).
Requires an SD card inserted in the AiSEG2. Shares the same cached download as get_history.
Returns long-form cost points ({timestamp, metric, value}) with values in Japanese yen.
Args:
granularity: "day" takes start/end as YYYY-MM-DD; "month" as YYYY-MM; "year" as YYYY.
start: Range start (inclusive), formatted per the granularity.
end: Range end (inclusive), formatted per the granularity.
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 | ||
| 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 |