For the complete documentation index, see llms.txt. This page is also available as Markdown.

Hyper Feed

Real-time sports incident feed with confidence-graded data

Welcome to the LSports Hyper Feed Integration Guide!

Overview

LSports Hyper Feed is a real-time service that delivers live sports incidents enriched with a confidence grade, enabling customers to power live visualizations, in-play analytics, and betting tools with unmatched speed and transparency and to analyze and act on data in real time, monitor and investigate live events with full transparency, boost in-play turnover, and gain a competitive edge by reacting faster and with clear visibility into the confidence level of each event.

To ensure context and event correlation, the LiveScore Feed is accompanied by a complementary Fixtures Feed that provides pre-event metadata (teams, league, location, sport, start time). Customers subscribe to two RabbitMQ queues and join incoming incidents with fixtures by fixtureId.


Understanding Confidence

Hyper Feed employs advanced decision models combining multi-provider validation with proprietary weighting algorithms. The confidence score reflects both provider consensus and historical accuracy patterns, continuously optimized by sport, league, and incident type. In the latest service version, only incidents meeting our quality thresholds are published.

Each incident carries a confidence score from 0.0 to 1.0. Use the thresholds below to decide how to act on an incident based on its score.

Confidence level
Threshold
Notes

Low

≤ 0.25

Suspensions and general-purpose use cases: widgets, match trackers, and notifications

Medium

≥ 0.25 and < 0.51

Risk, trading, and decisioning: automated trading workflows, operational alerts, risk exposure management, and odds creation based on higher-confidence signals

High

≥ 0.51

Settlement: confirming final outcomes


Choosing the right field for the right purpose

Several incident kinds carry a seconds field. They each mean something slightly different. Pick the right field for what you're trying to do:

  • You want the live match clock (e.g., to display "00:42:17" or to time-stamp other events against game time): read seconds from the Timer incident. It's the only continuous clock signal in the feed.

  • You want to know when a scoring play happened: read seconds from the Score incident for that play. It captures the in-period time of that specific play as the message was generated. It is not a running clock.

  • You want to know when a stat changed (e.g., a corner, a card, a shot on target): read seconds from the corresponding Statistic or PlayerStatistic incident.

  • You want to know when a period started or ended: read the Period incident with Status: "Started" / "Finished". Don't infer period boundaries from Timer values alone. Some sports have stoppage/added time, so the standard period length is not a reliable boundary signal.


Supported Sports

Football, Basketball, Baseball, Ice Hockey, American Football, Badminton, Bandy, Beach Volleyball, Bowls, Boxing, Curling, Darts, E-Games, Floorball, Futsal, Hockey (Field Hockey), Kabaddi, Netball, Padel, Snooker, Squash, Tennis, Water Polo, Handball, Volleyball, Chess, Lacrosse, Softball, Sumo, Table Tennis, Gaelic Sports, Australian Rules, Rugby Union, Rugby League


Incidents

Hyper Feed reports live incidents per sport type. Each incident has a stable Incident ID delivered in the id field of every LiveScore message. For the full catalog of incidents available per supported sport, see Incidents by Sport Type.

Last updated

Was this helpful?