#WebSocket Stream Reference

The Hydra WebSocket stream provides real-time intelligence data as it's collected. Connect to receive live aircraft positions, vessel tracks, OSINT signals, missile alerts, and market updates.

#Endpoint

wss://api.hydra.fast/v1/stream

Authentication is required. Pass your API key as a query parameter or header — see the Connection guide for details.

#How It Works

1. Connect — open an authenticated WebSocket to wss://api.hydra.fast/v1/stream
2. Receive snapshot — the server sends the current state (aircraft, vessels, signals, alerts, markets) scoped to your API key's permissions
3. Stream updates — incremental updates arrive as JSON messages with a type field
4. Stay alive — the server pings every 15 seconds; respond with pong to keep the connection open

#Rate Limits

• Maximum 10 concurrent connections per IP address
• Exceeding this returns HTTP 429 Too Many Connections on the upgrade request

#Message Format

Every message is a JSON object with type and data fields:

{
  "type": "aircraft",
  "data": { ... }
}

See Event Types for the full list of message types and their payloads.