This endpoint provides daily forecasts of solar radiation reaching the surface for power pools, regions and states in North America and Europe. Each value is the daily mean of downwelling shortwave radiation, weighted by installed utility-scale solar capacity so it reflects conditions at solar farms.
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 daily solar radiation for each group, the list of forecast dates, and each group's installed capacity.
| Name | Type | Description |
|---|---|---|
| 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. |
| 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 |