STATS

STATS Channel

The STATS channel delivers complete statistics snapshots periodically during live matches.

Availability

Plan
Available

BASIC

No

PRO

No

ULTRA

Yes

MEGA

Yes

Update Frequency

Update frequency depends on your subscription scope:

  • match / league scope: statistics are delivered immediately when data changes

  • all scope: statistics are accumulated and delivered as a batch every 30 seconds (batch_update)

Events

Event
Scope
Description

stats_update

match, league

Full statistics snapshot (immediate)

batch_update

all

Batched statistics for all matches (every 30s)


stats_update

Delivers a complete snapshot of all match statistics.

Message

Data Fields

Match State

Field
Type
Description

timer

string

Current match minute

extraTimer

string/null

Extra time minutes (e.g., "3" for 45+3)

status

string

Match status

score

string

Current score "teamA;teamB"

score1h

string/null

First half score (after halftime)

score2h

string/null

Second half score (after full time)

Statistics

All statistics are in format "teamA;teamB":

Field
Type
Description

possession

string

Ball possession percentage

attacks

string

Total attacks

dangerousAttacks

string

Dangerous attacks

shotsOnTarget

string

Shots on target

shotsOffTarget

string

Shots off target

totalShots

string

Total shots

shotsBlocked

string

Blocked shots

corners

string

Total corners

corners1h

string/null

First half corners

fouls

string

Fouls committed

yellowCards

string

Yellow cards

redCards

string

Red cards

yellowToRed

string

Second yellow (yellow to red) cards

substitutions

string

Substitutions made

throwIns

string

Throw-ins

injuries

string

Injuries

penalties

string

Penalties awarded

offsides

string

Offsides

xg

string/null

Expected goals (xG)

Match Status Values

Status
Description

NOT_STARTED

Match hasn't started

IN_PLAY

First half in progress

HALFTIME

Halftime break

IN_PLAY_2H

Second half in progress

EXTRA_TIME

Extra time in progress

PENALTIES

Penalty shootout

ENDED

Match finished

POSTPONED

Match postponed

CANCELLED

Match cancelled


batch_update

Delivers a batch of statistics snapshots for all live matches. Sent every 30 seconds to all scope subscribers only.

Message

Fields

Field
Type
Description

type

string

Always "batch_update"

channel

string

Always "STATS"

scope

string

Always "all"

timestamp

integer

Batch creation timestamp in milliseconds

matches

array

Array of match updates accumulated since last batch

matches[].matchId

string

Match public ID

matches[].leagueId

string

League/Championship public ID

matches[].data

object

Statistics snapshot (same fields as stats_update data)

Note: If a match has multiple updates within a 30-second window, only the latest data for that matchId is included in the batch.


Subscription Examples

Subscribe to all stats updates

Subscribe to a specific match

Subscribe to a league


Example: Processing Stats

Example: Building a Stats Display


Notes

  • Statistics are only sent while the match is live

  • Null values indicate the statistic is not yet available

  • The snapshot includes ALL available statistics, not just changed values

  • For real-time delta updates, use the STATS_REALTIME channel (MEGA plan only)

Last updated