MAIN

MAIN Channel

The MAIN channel delivers key match events in real-time as they occur.

Availability

Plan	Available
BASIC	No
PRO	Yes
ULTRA	Yes
MEGA	Yes

Events

Event	Description
match_start	Match has started
goal	A goal was scored
halftime	First half ended
second_half_start	Second half started
match_end	Match has ended

---

match_start

Fired when a match kicks off.

Message

{
  "type": "match_start",
  "channel": "MAIN",
  "matchId": "12345",
  "leagueId": "67890",
  "ts": 1705312800000,
  "data": {
    "teamA": {
      "id": "1001",
      "name": "Manchester United"
    },
    "teamB": {
      "id": "1002",
      "name": "Liverpool"
    },
    "championship": {
      "id": "67890",
      "name": "Premier League",
      "country": "England",
      "seasonName": "2023/2024"
    },
    "startDate": "2024-01-15T15:00:00Z"
  }
}

Data Fields

Field	Type	Description
teamA	object	Home team information
teamA.id	string	Team public ID
teamA.name	string	Team name
teamB	object	Away team information
teamB.id	string	Team public ID
teamB.name	string	Team name
championship	object	Championship information
championship.id	string	Championship public ID
championship.name	string	Championship name
championship.country	string	Country
championship.seasonName	string	Season name
startDate	string	Match start time (ISO 8601)

---

goal

Fired when a goal is scored.

Message

{
  "type": "goal",
  "channel": "MAIN",
  "matchId": "12345",
  "leagueId": "67890",
  "ts": 1705314600000,
  "data": {
    "score": "1;0",
    "timer": "23",
    "team": "A"
  }
}

Data Fields

Field	Type	Description
score	string	Current score in format "teamA;teamB"
timer	string	Match minute when goal was scored
team	string	Team that scored: "A" (home) or "B" (away)

Score Format

The score is formatted as "X;Y" where:

• X = Goals scored by Team A (home)

• Y = Goals scored by Team B (away)

Example: "2;1" means Team A is winning 2-1.

---

halftime

Fired when the first half ends.

Message

{
  "type": "halftime",
  "channel": "MAIN",
  "matchId": "12345",
  "leagueId": "67890",
  "ts": 1705315500000,
  "data": {
    "score": "1;1"
  }
}

Data Fields

Field	Type	Description
score	string	Score at halftime in format "teamA;teamB"

---

second_half_start

Fired when the second half kicks off.

Message

{
  "type": "second_half_start",
  "channel": "MAIN",
  "matchId": "12345",
  "leagueId": "67890",
  "ts": 1705316400000,
  "data": {
    "score": "1;1"
  }
}

Data Fields

Field	Type	Description
score	string	Current score at second half start

---

match_end

Fired when the match ends (full time, or after extra time/penalties if applicable).

Message

{
  "type": "match_end",
  "channel": "MAIN",
  "matchId": "12345",
  "leagueId": "67890",
  "ts": 1705318800000,
  "data": {
    "finalScore": "2;1",
    "score1h": "1;1"
  }
}

Data Fields

Field	Type	Description
finalScore	string	Final score in format "teamA;teamB"
score1h	string	First half score in format "teamA;teamB"

---

Subscription Examples

Subscribe to all MAIN events

{"action": "subscribe", "channel": "MAIN", "scope": "all"}

Subscribe to a specific match

{"action": "subscribe", "channel": "MAIN", "scope": "match:12345"}

Subscribe to a league

{"action": "subscribe", "channel": "MAIN", "scope": "league:67890"}

---

Example: Tracking a Match

ws.onmessage = (event) => {
  const msg = JSON.parse(event.data);

  if (msg.channel !== 'MAIN') return;

  switch (msg.type) {
    case 'match_start':
      console.log(`Match started: ${msg.data.teamA.name} vs ${msg.data.teamB.name}`);
      break;

    case 'goal':
      const [homeGoals, awayGoals] = msg.data.score.split(';');
      const scorer = msg.data.team === 'A' ? 'Home' : 'Away';
      console.log(`GOAL! ${scorer} team scores at ${msg.data.timer}'`);
      console.log(`Score: ${homeGoals} - ${awayGoals}`);
      break;

    case 'halftime':
      console.log(`Halftime: ${msg.data.score.replace(';', ' - ')}`);
      break;

    case 'second_half_start':
      console.log('Second half started');
      break;

    case 'match_end':
      console.log(`Full time: ${msg.data.finalScore.replace(';', ' - ')}`);
      console.log(`First half was: ${msg.data.score1h.replace(';', ' - ')}`);
      break;
  }
};