Skip to content

wxchange documentation

wxchange serves weather data through one REST API: numerical model forecasts (GFS, HRRR and more) at a point, along a route or over an area; surface observations and storm reports; MRMS radar; National Weather Service watches, warnings and advisories; and the Shyft Score, which measures how well each model has verified against what was observed.

Every request is made with an API key from your wxchange account, and the same key works from curl, from your own code and from the Python SDK.

Start here

  • Getting started: create a key, make your first request, and find your way around the responses.
  • Hosted notebooks: a JupyterLab in your browser with the Python SDK already installed. Sign in with your wxchange account and paste your key.

Reference

  • REST API: how requests, times, units and errors work, then every endpoint in the API reference, generated from the API's OpenAPI description.
  • Python SDK: forecasts, observations, radar, scores and advisories as pandas DataFrames and xarray Datasets, with retries and charts built in.

Your account

Keys, usage and your organization's members are managed in the wxchange app. A key belongs to one organization; what it may read is set by the scopes it was created with.