Weather Ruse
API Reference

Variables

All available forecast variables, units, and model availability.

Surface variables — availability matrix

✅ Available · — Not available

VariableUnitsGFSECMWF-IFSHRRRNAMICON-EUICON-GlobalAROME
air_temperature_2mK
dewpoint_temperature_2mK
relative_humidity_2m%
wind_u_10mm s-1
wind_v_10mm s-1
wind_gust_10mm s-1
mean_sea_level_pressurePa
total_precipitationkg m-2
total_cloud_cover%
low_cloud_cover%
mid_cloud_cover%
high_cloud_cover%
capeJ kg-1
visibilitym
snow_depthm
wind_u_50mm s-1
wind_v_50mm s-1
wind_u_80mm s-1
wind_v_80mm s-1
wind_u_100mm s-1
wind_v_100mm s-1

Energy applications

For wind energy, the API provides U and V wind components at 50 m, 80 m, and 100 m. The 80 m level corresponds to a common turbine hub height.

Wind speed from components:

wind_speed = sqrt(wind_u² + wind_v²)

Wind direction from components (meteorological convention, degrees from north):

wind_direction = (270 - atan2(wind_v, wind_u) * 180/pi) % 360

Hub-height wind availability by model:

HeightGFSECMWF-IFSHRRRNAMICON-EUICON-GlobalAROME
50 m
80 m
100 m

Pressure-level variables

Pressure-level variables follow the naming pattern:

{quantity}_{level}hpa

Available levels: 1000, 850, 700, 500, 300, 250 hPa.

Available quantities:

PatternUnitsDescription
temperature_{level}hpaKAir temperature
u_wind_{level}hpam s-1U-component of wind
v_wind_{level}hpam s-1V-component of wind
specific_humidity_{level}hpakg kg-1Specific humidity
geopotential_height_{level}hpamGeopotential height
vertical_velocity_{level}hpaPa s-1Vertical velocity (omega)

Examples: temperature_500hpa, u_wind_850hpa, geopotential_height_300hpa.

Pressure-level variables are available from the /profile endpoint. See Forecast Endpoints — /profile.


Unit conversion

Values are returned in CF-standard units. Common conversions:

FromToFormula
K (temperature)°C°C = K − 273.15
Pa (pressure)hPahPa = Pa / 100
kg m-2 (precipitation)mmmm = kg m-2 (water density 1 kg/L)
m s-1 (wind)km/hkm/h = m s-1 × 3.6
m s-1 (wind)knotskn = m s-1 × 1.944

On this page