WeatherFlow Smart Weather API Websocket Reference

Endpoints

ws://ws.weatherflow.com/swd/data
wss://ws.weatherflow.com/swd/data

Request Messages

Request MessageResponse Message TypesDescription
{
  "type":"listen_start",
  "device_id":1110,
  "id":"2098388936"
}
ack
obs_air
obs_sky
evt_strike
evt_precip
Start listening for all new observations and events for a device_id. Each new observation sent by the Device will be pushed to the client as soon as possible. All Device events will be immediatly pushed.
{
  "type":"listen_stop",
  "device_id":1110,
  "id":"2098388936"
}
ack Stop listening for all messages for a Device.
{
  "type":"listen_start_events",
  "station_id":2594,
  "id":"2098388541"
}
ack
evt_station_online
evt_station_offline
Start listening for all Station online and offline events. All Station events will be immediatly pushed.
{
  "type":"listen_stop_events",
  "station_id":2594,
  "id":"2098388541"
}
ack Stop listening for all event messages for a Station.
{
  "type":"listen_rapid_start",
  "device_id":1110,
  "id":"2098388542"
}
ack
rapid_wind
Start listening for rapid 3 second wind data for a Sky Device.
{
  "type":"listen_rapid_stop",
  "device_id":1110,
  "id":"2098388587"
}
ack Stop listening for rapid data messages for a Device.

Response Messages

Acknowledgement [type = ack]

{
  "type":"ack",
  "id":"2098388936"
}


Rain Start Event [type = evt_precip]

{
  "type":"evt_precip",
  "device_id":1110
}


Lightning Strike Event [type = evt_strike]

{
  "type":"evt_strike",
  "device_id":1110,
  "evt":[1493322445,27,3848]
}
Evt Value Layout
IndexFieldUnits
0Time EpochSeconds
1Distancekm
2Energy


Device Online Event [type = evt_device_online]

{
  "type":"evt_device_online",
  "device_id":1110
}


Device Offline Event [type = evt_device_offline]

{
  "type":"evt_device_offline",
  "device_id":1110
}


Station Online Event [type = evt_station_online]

{
  "type":"evt_station_online",
  "station_id":4582
}


Station Offline Event [type = evt_station_offline]

{
  "type":"evt_station_offline",
  "station_id":4582
}


Rapid Wind [type = rapid_wind] (3 second interval)

{
  "type":"rapid_wind",
  "device_id":1110,
  "ob":[1493322445,2.3,128]
}
Ob Value Layout
IndexFieldUnits
0Time EpochSeconds
1Wind Speedm/s
2Wind DirectionDegrees


Observation (Air) [type = obs_air]

{
  "type":"obs_air",
  "device_id":1110,
  "obs":[[1493164835,835.0,10.0,45,0,0,3.46,1]]
}
Observation Value Layout
IndexFieldUnits
0Time EpochSeconds
1Station PressureMB
2Air TemperatureC
3Relative Humidity%
4Lightning Strike Count
5Lightning Strike Avg Distancekm
6BatteryVolts
7Report IntervalMinutes


Observation (Sky) [type = obs_sky]

{
  "type":"obs_sky",
  "device_id":1110,
  "obs":[[1493321340,9000,10,0.0,2.6,4.6,7.4,187,3.12,1,130,1.034,0,3,0.0,1.011,1]]
}
Observation Value Layout
IndexFieldUnits
0Time EpochSeconds
1IlluminanceLux
2UVIndex
3Rain Accumulatedmm
4Wind Lull (minimum 3 second sample)m/s
5Wind Avg (average over report interval)m/s
6Wind Gust (maximum 3 second sample)m/s
7Wind DirectionDegrees
8BatteryVolts
9Report IntervalMinutes
10Solar RadiationW/m^2
11Local Daily Rain Accumulationmm
12Precipitation Type0 = none, 1 = rain, 2 = hail
13Wind Sample Intervalseconds
14Rain Accumulated Final (Rain Check)mm
15Local Daily Rain Accumulation Final (Rain Check)mm
16Precipitation Analysis Type0 = none
1 = Rain Check with user display on
2 = Rain Check with user display off

Other Useful Information