This endpoint provides daily wind speed, cloud cover and solar radiation forecasts for power pools, regions and states in North America and Europe, all from the same model run. Wind is weighted by installed wind capacity; cloud cover and solar radiation are weighted by installed utility-scale solar capacity.
Choose a supported forecast model using the dropdown. When no initialization time is specified, results come from the latest run whose weighted forecasts have been calculated, which can be older than the model's latest forecast run. To list calculated runs, use Calculation Times with calculation_type set to weighted_wind_solar.
| Name | Type | Description |
|---|---|---|
| initialization_time Optional | string (ISO 8601 or YYYYMMDDHH or latest) | The initialization time for the forecast. Default: latest calculated initialization time |
| group_by Optional | string | How to group the capacity. In North America, pool is a power pool (keys such as PJM and ERCOT), region is a zone within a pool (keys such as PJM West), and state is a US state or Canadian province (keys such as CA and TX). In Europe, pool and state are countries (keys such as Germany), and region is a bidding zone (keys such as DK1 and IT-NORD). A pool or country with only one zone keeps its own name under region. Allowed: pool, region, state; Default: pool |
| market Optional | string | Power market to return. Allowed: na, eu; Default: both North America and Europe |
Returns all three products, the list of forecast dates, and the variable, unit and capacity for each product.
| Name | Type | Description |
|---|---|---|
| wind | object | Daily mean wind speed at 100 m, weighted by installed wind capacity. |
| <date> | object | Keyed by group name, with values for that local date. Thanks to Europe being in an earlier timezone, the last date may sometimes only contain European groups. |
| <group> | number | null | Daily mean for the group and local date; null when the group has no capacity, or when the forecast does not cover the full local day at every location with capacity in the group. Unit: m/s |
| cloud_cover | object | Daily mean total cloud cover, weighted by installed utility-scale solar capacity. |
| <date> | object | Keyed by group name, with values for that local date. Thanks to Europe being in an earlier timezone, the last date may sometimes only contain European groups. |
| <group> | number | null | Daily mean for the group and local date; null when the group has no capacity, or when the forecast does not cover the full local day at every location with capacity in the group. Unit: % |
| solar_radiation | object | Daily mean shortwave radiation reaching the surface, weighted by installed utility-scale solar capacity. |
| <date> | object | Keyed by group name, with values for that local date. Thanks to Europe being in an earlier timezone, the last date may sometimes only contain European groups. |
| <group> | number | null | Daily mean for the group and local date; null when the group has no capacity, or when the forecast does not cover the full local day at every location with capacity in the group. Unit: W/m² |
| dates | string[] (YYYY-MM-DD) | Forecast dates in ascending order, as local dates at the location of the capacity. |
| metadata | object | Forecast calculation metadata. |
| model | string | Model whose forecast output was used. May differ from the model in the URL, such as WeatherMesh for wm-6. |
| subset | string | Forecast subset identifier. |
| initialization_time | string (ISO 8601) | The forecast initialization time. |
| group_by | string | Grouping used for the values. Allowed: pool, region, state |
| market | string | Power market returned; all when the request did not set market. Allowed: na, eu, all |
| time_zone | string | How dates are assigned. Always local_at_capacity_cell: each date is the local calendar date at the location of the capacity, adjusted for daylight saving time. A group that spans time zones combines different UTC hours under one date. Allowed: local_at_capacity_cell |
| input_fingerprint | string | Identifier of the inputs used for the calculation. |
| variables | object | Variable, unit and capacity for each product, keyed by product name. |
| wind | object | Daily mean wind speed at 100 m, weighted by installed wind capacity. |
| variable | string | Weather variable averaged to produce the values. Allowed: wind_speed_100m |
| unit | string | Unit of the values. Allowed: m/s |
| capacity_mw | object | Installed nameplate capacity that each group is weighted by. Wind uses wind capacity; cloud cover and solar radiation use utility-scale solar capacity, which excludes rooftop solar. Unit: MW |
| <group> | number | Installed capacity in the group. Unit: MW |
| cloud_cover | object | Daily mean total cloud cover, weighted by installed utility-scale solar capacity. |
| variable | string | Weather variable averaged to produce the values. Allowed: total_cloud_cover |
| unit | string | Unit of the values. Allowed: % |
| capacity_mw | object | Installed nameplate capacity that each group is weighted by. Wind uses wind capacity; cloud cover and solar radiation use utility-scale solar capacity, which excludes rooftop solar. Unit: MW |
| <group> | number | Installed capacity in the group. Unit: MW |
| solar_radiation | object | Daily mean shortwave radiation reaching the surface, weighted by installed utility-scale solar capacity. |
| variable | string | Weather variable averaged to produce the values. Allowed: surface_downwelling_shortwave_radiation |
| unit | string | Unit of the values. Allowed: W/m² |
| capacity_mw | object | Installed nameplate capacity that each group is weighted by. Wind uses wind capacity; cloud cover and solar radiation use utility-scale solar capacity, which excludes rooftop solar. Unit: MW |
| <group> | number | Installed capacity in the group. Unit: MW |