> For the complete documentation index, see [llms.txt](https://docs.sendstackhq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sendstackhq.com/guides/websockets.md).

# Websockets

Our websockets provide real-time data updates for your tracking devices, ensuring you stay informed as changes occur.

**How It Works**

1. **Authentication**\
   To initiate a WebSocket connection, a valid **session** must be included in the request query.
   * Learn how to generate a session ID [here](/the-basics/session.md) (link to detailed instructions).
2. **Websocket Connection**\
   Once connected, the websocket will stream real-time data for your tracking devices. Key details to note:
   * **Data Streaming**: Real-time updates are sent as long as the connection remains active.
   * **Rate Limiting**: A maximum of **2 responses per second** is enforced to ensure optimal performance.
   * **Update Triggers**: Updates are only sent when there is a change in the status or location of at least one of your tracking devices.
3. **Getting Started**\
   For step-by-step instructions on connecting to the websocket, refer to our[ websocket connection guide](/live-tracking-apis/positions/stream-positions.md) (link to detailed instructions).