OptionaldataOverrides the param's data_type sent to the backend (rarely needed).
OptionaldateSingle completed window: YYYY-MM-DD (or YYYY-MM-DDTHH for hourly).
OptionalendRange of completed windows: end date YYYY-MM-DD (with startDate).
OptionalendRange end, Unix timestamp in milliseconds (raw queries; defaults to now).
OptionalkeyOverrides the backend param key entirely, skipping the node-config
lookup. Required for data models the config lookup cannot resolve —
e.g. Matter attributes, whose key is "0x<ep>.0x<cluster>.0x<attr>"
in lowercase, unpadded hex — the exact format the firmware publishes.
Must be paired with dataType, since a Matter node config carries no
data types.
OptionalpagePage size (backend default 20).
OptionalstartRange of completed windows: start date YYYY-MM-DD (with endDate).
OptionalstartOpaque pagination token from a previous result's nextKey.
OptionalstartRange start, Unix timestamp in milliseconds (raw queries; required).
OptionalwindowAggregation window (aggregate queries; required).
Options for time-series data queries.
Raw queries (
getRawTSData):startTsis required (Unix ms; seconds are also accepted by the backend),endTsdefaults to now. Aggregate queries (getTSData):windowis required. Provide either no date (current live window),date(single completed window), orstartDate+endDate(paginated range of completed windows).