Get Continuous Forecast
Retrieve a continuous forecast series for a specific metric, ISO and time period.
This endpoint combines forecasts from multiple model runs to create a seamless
timeseries. For each day in the requested date range, the endpoint selects the
forecast published at latest_hour (local time) with a lead time of days_ahead days.
These individual forecasts are then stitched together into a single continuous timeseries.
Note that data is only available from January 1, 2026 onwards.
Access: Requires core subscription level.
Authentication
API key for authentication. Can also be provided in the api_key query parameter.
Path parameters
Query parameters
The local hour (0–23) to use for selecting the model run each day.
Response
Identifier of the weather model used for this forecast (e.g., ‘optimized’, ‘iso’). Null for historical actuals or composite responses.
Timestamp (UTC) when this forecast was created/published. Represents the model run time. Null for continuous/stitched forecasts or historical actuals.
Measurement units for all data values in the response. Common values: ‘MW’ (megawatts), ‘°C’ (degrees Celsius), ‘USD/MWh’, ’$/MMBtu’.
IANA timezone identifier used for the time_local field. Typically matches the region’s local timezone.
Array of timestamps in Coordinated Universal Time (UTC). Each entry corresponds to one row in the values matrix. Always timezone-aware.
Array of timestamps in local time (timezone specified in timezone field). Each entry corresponds to one row in the values matrix. Parallel to time_utc.
Metadata describing each column in the values matrix. Each entry is a list of one or more level labels — single-level columns are returned as length-1 sublists (e.g. [‘pjm_total’]); naturally multi-level data uses one entry per level (e.g. [‘pjm_total’, ‘demand’]). Clients can rebuild a pandas MultiIndex via pd.MultiIndex.from_tuples(columns).
2D matrix of numeric forecast or actual values in column-major order. Each inner list represents a series (corresponding to columns), and each element within that list corresponds to a timestamp (corresponding to time_utc/time_local). Missing or unavailable data is represented as null.
