Options for time-series data queries.

Raw queries (getRawTSData): startTs is required (Unix ms; seconds are also accepted by the backend), endTs defaults to now. Aggregate queries (getTSData): window is required. Provide either no date (current live window), date (single completed window), or startDate + endDate (paginated range of completed windows).

interface ESPRMNeoTSDataOptions {
    dataType?: string;
    date?: string;
    endDate?: string;
    endTs?: number;
    key?: string;
    pageSize?: number;
    startDate?: string;
    startKey?: string;
    startTs?: number;
    window?: ESPRMNeoTSAggregationWindow;
}

Properties

dataType?: string

Overrides the param's data_type sent to the backend (rarely needed).

date?: string

Single completed window: YYYY-MM-DD (or YYYY-MM-DDTHH for hourly).

endDate?: string

Range of completed windows: end date YYYY-MM-DD (with startDate).

endTs?: number

Range end, Unix timestamp in milliseconds (raw queries; defaults to now).

key?: string

Overrides 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.

pageSize?: number

Page size (backend default 20).

startDate?: string

Range of completed windows: start date YYYY-MM-DD (with endDate).

startKey?: string

Opaque pagination token from a previous result's nextKey.

startTs?: number

Range start, Unix timestamp in milliseconds (raw queries; required).

Aggregation window (aggregate queries; required).