Pre-game¶
Product id: pregame
A game's main lines before it starts: its result, its handicap and its totals, the game's and each team's, for the whole game and for each period (halves, quarters, periods, innings, sets…), with their alternate lines.
What is in it¶
These market types, in every period the sport has, and their alternate lines (main: false):
| Type | Form | What it is |
|---|---|---|
moneyline |
12 |
The winner, without a draw |
match_result |
1x2 |
Home, draw or away |
double_chance |
dc |
Two of the three results |
draw_no_bet |
12 |
The winner; a draw returns the stake |
spread |
hcp |
The handicap on the score |
asian_handicap |
hcp |
The handicap with quarter lines |
set_spread |
hcp |
The handicap on sets |
total |
ou |
The total of the score |
total_sets |
ou |
The total of sets |
team_total |
ou |
One team's total; the team is the market's participant |
A period is not another type: a first-half total is a total with period: "1h". Every other
market of the game (player props, corners, cards, correct score, exact totals, odd/even…) is in
Props. A market is in one of the two products, never in both: its type decides.
Next to our own lines (book: null), each game carries the sportsbooks' lines, such as bet365,
DraftKings or Pinnacle. A book's lines are its moneyline (or
match_result), spread (with alternate spreads), total and team_total; each one is a market
of its own, with the book in book, its opening line in opening and, at the start, its closing
line. The books' lines are not graded. Games that only the sportsbooks list are events of their
own. See Sportsbooks and the books catalog.
Complete example: an NBA game with a moneyline, a spread, a first-half total and a book's spread with its opening line.
The board¶
- Every game we offer before its start is on the
pregameboard, even while it has no main line yet. A game is on thepropsboard only while it has a market there. GET /v1/pregame/eventslists the board;GET /v1/pregame/events/{eventId}gives one game with its markets; the stream (products=pregame) follows it.- A game keeps its
evt_when it starts: in play it is offered in Live. It leaves thepregameandpropsboards (anevent.remove) when betting before the start is over. - A book's market in
pregameisclosedwhen the game starts. Its lastlineandpriceare the closing line, and itsupdatedAtis the start. - When the sportsbooks' lines cannot be kept current for more than a short while, every book's
market is
suspendedwith its last prices until they are again. Our own lines and the product'sfeed.statusare not affected. - A start that moves is an
event.upsertwith the newstartAt;schedule.originalStartAtkeeps the first one (Schedule).
Typical use¶
- Show the board: load
GET /v1/pregame/eventsonce, then open the stream withproducts=pregameand apply its messages. - Only some lines: filter the stream with
marketTypes=moneyline,spread,totalorperiods=match, or narrow one event with the same parameters. - Odds screen: group a game's markets by
type,period,participantandmain, and show one column perbook(ours isbook: null). There is no filter by book: every book comes. - Line moves: a book's main market keeps its id while its line moves, so each
market.upsertof it is one step of that book's line; compare withopeningfor the move since it opened. - Rotation numbers: each game carries
rotation, the numbers sportsbooks print on the board (Rotation numbers).