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) andclock(the current period, the seconds elapsed in it, and whether it runs). rotationandschedule, 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 noopening, 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
suspendedwith its last prices. Once they come back, a game in play stays suspended until a new line of that game comes. Our own lines andfeed.statusare not affected. See Sportsbooks. - Games only the books list are in
livetoo while under way, with the books' lines only: noscoreorclock.
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
suspendedmarket or selection cannot be bet. Its last price is kept so you can show it greyed out; it comes backopenwith 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 amarket.remove. A removed market can come back later, with the id it had: treat amarket.upsertfor it as new. - When the product's
feed.statusisdegraded, treat every open market as suspended until it isokagain (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
livewhen it starts, with the sameevt_it had inpregameandprops. - Its
statusislivewhile 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
statusmay turnfinishedwith 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=liveon the stream; narrow it withsports,leagues,events,groups,marketTypesorperiods. - Live props only:
groups=player. - Score and clock without prices: that is Scores, which carries the same games as events without markets.