Getting started

This guide explains how to establish and maintain a WebSocket connection to the Soccer Football API real-time service.

Connection URL

There is two connection urls:

wss://ws-eu.soccerfootball.info/?token=YOUR_WEBSOCKET_TOKEN

wss://ws-as.soccerfootball.info/?token=YOUR_WEBSOCKET_TOKEN

You must use the connection URL in response of /v1/ws/new call.

Connection flow

1. GET /v1/ws/new → Obtain WebSocket token

2. Connect to WSS → Establish WebSocket connection

3. Subscribe to channels → Start receiving events

4. Handle events → Process incoming messages

5. Renew token → Before expiration (every ~25 minutes)