Live fleet data, ready to display.
Display live TrackSim telemetry in maps, dashboards, overlays, and other viewer experiences.
wss://gateway.tracksim.app/v1/ws#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
- Connect to
wss://gateway.tracksim.app/v1/ws. - Send a UTF-8 JSON
subscribemessage containing acompany_idandgame. - Wait for the
SUBSCRIBEDevent that confirms the active feed and snapshot interval. - Render each
TELEMETRY_SNAPSHOTevent 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
| Item | Value |
|---|---|
| Endpoint | wss://gateway.tracksim.app/v1/ws |
| Protocol version | 1 |
| Client messages | UTF-8 JSON text frames |
| Server updates | Full telemetry snapshots |
| Feed selection | Company ID and game |
| Incoming message limit | 256 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.