# Optional Queries ## Segment List Query The **Segment List** query retrieves all segments within a given dataset. ### **Input Parameter** Your query should support the following: * **`dataset`** *(Required)* – A key-value pair for each metadata key checked in the dataset filter. Used in queries as `{{ dataset.id }}`. ### **Expected Output** Each segment should be represented as a row containing: * **`id`** *(Required)* – The unique identifier of the segment. * **`label`** *(Required)* – A descriptive label for the segment. * **`start`** *(Required)* – The timestamp of the first data point in the segment in nanoseconds. * **`stop`** *(Required)* – The timestamp of the last data point in the segment in nanoseconds. * **Additional metadata fields** *(Optional)* – Any relevant metadata attributes.

## Other Optional Queries In addition to the core queries, Marple supports several optional queries for improved performance and functionality: * **Time Series Batch** – Retrieves data for multiple signals within a time range, with optional subsampling. * **Cursor Values** – Fetches signal values at a specific timestamp, useful for scatter plots and maps. * **Cursor Statistics** – Computes min, max, and mean values within a time range. * **Signal Table** – Joins multiple signals into a single table with a common timestamp column. * **Sandbox Signal** – Derives a new signal from existing ones using a formula. * **Sandbox Preview** – Previews the results of a derived signal before applying it.