Skip to content

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 pregame board, even while it has no main line yet. A game is on the props board only while it has a market there.
  • GET /v1/pregame/events lists 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 the pregame and props boards (an event.remove) when betting before the start is over.
  • A book's market in pregame is closed when the game starts. Its last line and price are the closing line, and its updatedAt is the start.
  • When the sportsbooks' lines cannot be kept current for more than a short while, every book's market is suspended with its last prices until they are again. Our own lines and the product's feed.status are not affected.
  • A start that moves is an event.upsert with the new startAt; schedule.originalStartAt keeps the first one (Schedule).

Typical use

  • Show the board: load GET /v1/pregame/events once, then open the stream with products=pregame and apply its messages.
  • Only some lines: filter the stream with marketTypes=moneyline,spread,total or periods=match, or narrow one event with the same parameters.
  • Odds screen: group a game's markets by type, period, participant and main, and show one column per book (ours is book: 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.upsert of it is one step of that book's line; compare with opening for the move since it opened.
  • Rotation numbers: each game carries rotation, the numbers sportsbooks print on the board (Rotation numbers).

Combine it with

  • Props: the rest of the same game's markets, under the same evt_.
  • Live: the same game in play.
  • Scores: the scoresheet to settle with your own rules.
  • Grading: our verdict on each pregame selection, with GET /v1/pregame/grading.