WeatherFlow Tempest API Websocket Reference

Endpoints

wss://ws.weatherflow.com/swd/data?token=[your_access_token]

For more information about how to obtain an access token, see our getting started guide.

Request Messages

Request MessageResponse Message TypesDescription
{
  "type":"listen_start",
  "device_id":1110,
  "id":"2098388936"
}
ack
obs_air
obs_sky
obs_st
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_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


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


Observation (Tempest) [type = obs_st]

{
  "type":"obs_st",
  "device_id":62009,
  "obs": [[1603481377,0,0.09,0.54,33,6,1014.8,28.8,71,16639,1.83,139,0,0,0,0,2.42,1,0.07615,null,null,0]]
}
Observation Value Layout
IndexFieldUnits
0Time EpochSeconds
1Wind Lull (minimum 3 second sample)m/s
2Wind Avg (average over report interval)m/s
3Wind Gust (maximum 3 second sample)m/s
4Wind DirectionDegrees
5Wind Sample Intervalseconds
6Station PressureMB
7Air TemperatureC
8Relative Humidity%
9IlluminanceLux
10UVIndex
11Solar RadiationW/m^2
12Rain Accumulatedmm
13Precipitation Type0 = none, 1 = rain, 2 = hail
14Lightning Strike Avg Distancekm
15Lightning Strike Count
16BatteryVolts
17Report IntervalMinutes
18Local Daily Rain Accumulationmm
19Rain Accumulated Final (Rain Check)mm
20Local Daily Rain Accumulation Final (Rain Check)mm
21Precipitation Analysis Type0 = none
1 = Rain Check with user display on
2 = Rain Check with user display off

Other Useful Information