Skip to main content

Sensor data

Sites can have sensors attached to them that report measurement data. Today, this API exposes readings from environmental sensors typically installed alongside a rooftop PV system. A single sensor can report several measurement channels:

  • Irradiance (irradiance, W/m²)
  • Cell temperature (cell_temperature, °C): the PV module's own temperature
  • External temperature (external_temperature, °C): ambient air temperature
  • Wind speed (wind_speed, m/s)

Not every sensor reports every channel. The metadata endpoint lists exactly which channels a given sensor exposes.

Typical use cases​

  • Compare measured irradiance against a PV resource's actual output to estimate what production should have been during a curtailment window.
  • Feed irradiance time series into your own PV performance models or billing calculations.
  • Refine those models with cell temperature and wind speed (panel efficiency falls as cell temperature rises, and wind cools the modules).
  • Cross-check forecasting accuracy against measured ground-truth conditions.

What the API does not do​

  • No aggregation. Only raw readings are returned. Hourly, daily or monthly rollups are for the client to compute (for example with pandas resample).
  • No server-side gap filling. Intervals with no reading are omitted from the response. If you need a regular time grid, reindex client side.
  • No CSV or bulk export. JSON over HTTP only.

Getting started​

  • Reading sensor data walks through the endpoint, parameters, and pagination pattern with a pandas example.