Event types

Every message has a type. Scoring events carry a tier (provisional or confirmed), confidence (agreement %, reporter count, latency), the game clock, and — where the source provides it — the player. Subscribe to a whole sport, a single league, or one event type.

Lifecycle events

TypeDescription
game.startedThe game/match has started; the stream is live.
period.startedA new period / quarter / half / inning / set / round began.
scoreA scoring event — see the per-sport tables below.
period.endedA period ended, with the running score.
game.finalFinal, reconciled against the official record.
correctionA previously emitted event was revised.

Tiers

TierMeaningPlans
confirmedReputation-weighted consensus cleared — trust it.All plans
provisionalA single early report, tagged. Fastest, may be revised.Growth and up

A provisional event is always followed by a confirmed or a correction. Subscribe per tier on WebSocket or webhooks.

Scoring events by sport

Each scoring event is namespaced {sport}.{type} and carries an integer points value (or a unit for sports that don't score in points). One endpoint can subscribe across multiple sports and leagues.

Basketball

basketball.* · NBA · NCAAB (men's & women's) · WNBA · EuroLeague

Event typeDescriptionPoints
basketball.fg Field goal 2
basketball.three Three-pointer 3
basketball.ft Free throw 1

American Football

football.* · NFL · NCAAF · CFL

Event typeDescriptionPoints
football.td Touchdown 6
football.fg Field goal 3
football.xp Extra point 1
football.2pt Two-point 2
football.safety Safety 2

Baseball

baseball.* · MLB · NCAA Baseball · MiLB (on demand)

Event typeDescriptionPoints
baseball.run +1 run 1

Hockey

hockey.* · NHL · NCAA Hockey

Event typeDescriptionPoints
hockey.goal Goal 1

Soccer

soccer.* · EPL · La Liga · Serie A · Bundesliga · Ligue 1 · MLS · UEFA Champions / Europa · World Cup & Euros · + 340 more

Event typeDescriptionPoints
soccer.goal Goal 1

Tennis

tennis.* · ATP Tour · WTA Tour · Grand Slams · ATP/WTA 1000s

Event typeDescriptionPoints
tennis.point Point
tennis.game Game
tennis.set Set

Golf

golf.* · PGA Tour · Majors · LIV Golf · DP World Tour

Event typeDescriptionPoints
golf.eagle Eagle
golf.birdie Birdie
golf.par Par
golf.bogey Bogey

Cricket

cricket.* · IPL · T20 Internationals · ODI · Test · BBL

Event typeDescriptionPoints
cricket.run +1 1
cricket.four Four 4
cricket.six Six 6
cricket.wicket Wicket

Rugbysoon

rugby.* · Six Nations · Premiership · Super Rugby · NRL

Planned events: Try · Conversion · Penalty / drop. The scoring taxonomy goes live when Rugby opens.

MMA & Boxingsoon

mma.* · UFC · Major boxing cards

Planned events: Round · Finish. The scoring taxonomy goes live when MMA & Boxing opens.

Racingsoon

racing.* · F1 · NASCAR · Horse racing

Planned events: Position change · Finish. The scoring taxonomy goes live when Racing opens.

Questions? Talk to us. Pre-launch — endpoints illustrate the shape of the API.