Query time-series datum
query_datumQuery solar telemetry across multiple nodes and sources, returning mean power, total energy, and irradiance for any date range with configurable roll-up periods.
Instructions
Query time-series data over a date range, rolled up by an aggregation period. Accepts multiple nodes at once. Returns one series per source with mean power, total energy and mean irradiance. Use Day for week-to-month questions, Hour or FifteenMinute to inspect a single day's shape, and Month for year-scale trends. Note that watts is averaged power; for true energy totals use get_energy instead.
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>",
"startDate": "<startDate>",
"endDate": "<endDate>"
},
"name": "query_datum"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| endDate | Yes | Exclusive end, YYYY-MM-DD | |
| nodeIds | Yes | One or more SolarNetwork node IDs | |
| sourceIds | No | Restrict to these source IDs; omit for all sources | |
| startDate | Yes | Inclusive start, YYYY-MM-DD | |
| aggregation | No | Roll-up period | Day |