Skip to content

Live

Product id: live

Every market of a game in play, live props included: the game's lines, team and statistics markets and player props, with the live score and the game clock.

What is in it

  • Every market type the game offers in play, in every group (game, team, stats, player): there is no split between main lines and props once the game has started.
  • The event's score (with the score of each period) and clock (the current period, the seconds elapsed in it, and whether it runs).
  • rotation and schedule, as before the start.
  • The sportsbooks' lines in play: markets with a book, as in Pre-game, for the games under way only, from the start until the game is over. They are markets of their own, with their own ids and no opening, holding only the lines each book posted since the start; their prices are updated every few seconds. The book's pre-game market closed at the start, with its closing line.
  • When the books' lines are interrupted, every book market is suspended with its last prices. Once they come back, a game in play stays suspended until a new line of that game comes. Our own lines and feed.status are not affected. See Sportsbooks.
  • Games only the books list are in live too while under way, with the books' lines only: no score or clock.

Complete example: a soccer game at 1-0 in the second half, with the match result, the total and a suspended player prop.

Prices in play

Live prices move fast and markets are suspended often (a goal, a penalty, a dangerous attack, a review):

  • A suspended market or selection cannot be bet. Its last price is kept so you can show it greyed out; it comes back open with a fresh price when betting resumes.
  • A selection without a price is never open.
  • A market that will not reopen is closed, or is dropped with a market.remove. A removed market can come back later, with the id it had: treat a market.upsert for it as new.
  • When the product's feed.status is degraded, treat every open market as suspended until it is ok again (Connecting).

Follow live on the stream: each change is one market.upsert with the whole market. Polling REST cannot keep up with in-play prices.

Lifecycle

  • A game enters live when it starts, with the same evt_ it had in pregame and props.
  • Its status is live while it is played. When betting pauses for a while, its markets are suspended and the game stays on the board.
  • When it is over, its status may turn finished with the final score, and it leaves the board (event.remove). Its scoresheet then comes in Scores, and our verdicts in Grading.

Typical use

  • In-play board: products=live on the stream; narrow it with sports, leagues, events, groups, marketTypes or periods.
  • Live props only: groups=player.
  • Score and clock without prices: that is Scores, which carries the same games as events without markets.

Combine it with

  • Pre-game and Props: the same game before it starts.
  • Scores: the scoreboard and the final scoresheet.
  • Grading: our verdict on each live selection, with GET /v1/live/grading.