Public viewer feedWebSocket · Protocol v1

Live fleet data, ready to display.

Display live TrackSim telemetry in maps, dashboards, overlays, and other viewer experiences.

Gateway connectionOPEN
Secure WebSocketwss://gateway.tracksim.app/v1/ws
CLIENTsubscribe
{
  "version": 1,
  "op": "subscribe",
  "data": { "company_id": 42, "game": "eut2" }
}
GATEWAY EVENTTELEMETRY_SNAPSHOT
1,000 ms
AccessPublic viewerNo account or API key
TransportSecure WebSocketUTF-8 JSON text frames
UpdatesFull snapshotsConfigured feed interval
ProtocolVersion 1256 KiB message limit

#What is TrackSim Gateway?

TrackSim Gateway is a secure WebSocket service for viewing a company's live telemetry feed. A viewer selects a company and game, then receives full snapshots of the drivers currently included in that feed.

The connection stays open so your application can update as each new snapshot arrives. No account or API key is required to view a feed.

#How it works

  1. Connect to wss://gateway.tracksim.app/v1/ws.
  2. Send a UTF-8 JSON subscribe message containing a company_id and game.
  3. Wait for the SUBSCRIBED event that confirms the active feed and snapshot interval.
  4. Render each TELEMETRY_SNAPSHOT event as the latest complete state of that feed.

You can send another subscription on the same connection when the viewer needs to change company or game feeds.

#What can I build?

Gateway snapshots can power viewer experiences such as:

  • Live company maps.
  • Fleet and dispatch dashboards.
  • Stream and event overlays.
  • Public status displays.
  • Custom telemetry visualisations.

#Protocol at a glance

ItemValue
Endpointwss://gateway.tracksim.app/v1/ws
Protocol version1
Client messagesUTF-8 JSON text frames
Server updatesFull telemetry snapshots
Feed selectionCompany ID and game
Incoming message limit256 KiB by default

Binary frames are not part of protocol version 1.

#Continue to the viewer guide

The Public Viewer guide contains the subscription request, server events, browser example, feed switching, errors, and slow-viewer behaviour.