Skip to main content
The Polymarket Sports WebSocket API provides real-time sports results updates. Clients connect to receive live match data including scores, periods, and game status as events happen. Endpoint:
wss://sports-api.polymarket.com/ws
No authentication is required. This is a public broadcast channel that streams updates for all active sports events.

How It Works

Once connected, clients automatically receive JSON messages whenever a sports event updates. There is no subscription message required—simply connect and start receiving data.

Connection Management

Automatic Ping/Pong Heartbeat

The server sends PING messages at regular intervals. Clients must respond with PONG to maintain the connection.
ParameterDefaultDescription
PING Interval5 secondsHow often the server sends PING messages
PONG Timeout10 secondsHow long the server waits for a PONG response
If your client doesn’t respond to PING within 10 seconds, the connection will be closed automatically.

Connection Health

  • Server sends PING → Client must respond with PONG
  • No response within timeout → Connection terminated
  • Clients should implement automatic reconnection with exponential backoff

Session Affinity

The server uses cookie-based session affinity (sports-results cookie) to ensure clients maintain connection to the same backend instance. This is handled automatically by the browser.

Next Steps