Skip to content

Props

Product id: props

Every market of a game before it starts that is not a main line: player props, and the game's and the teams' specials.

What is in it

Every market type except the ten main-line types of Pre-game:

Group Examples
player Points, rebounds, assists; passing, rushing and receiving yards; touchdowns; hits, strikeouts, total bases; shots, saves; goalscorers; cards; as over/under, yes/no, exact figures, bands or "who will" markets
game Correct score, half-time/full-time, exact and winning margins, both teams to score, first and last team to score, race to N, result and total combinations, exact totals, total bands, odd/even, touchdowns and field goals, largest lead
team Win to nil, clean sheet, win both halves, team odd/even, team exact totals, team corners and cards
stats Corners, cards, shots on target, offsides, fouls, throw-ins, and American football and basketball team statistics

The complete list, with the form of each type, is in Market types.

A player prop names its player in the market's participant ({id, name, number}, with the player's par_ id), and its name reads like "Patrick Mahomes Passing Yards". A team market names its team the same way.

Complete example: an NFL game with a quarterback's passing yards and the game's total touchdowns.

The board

  • A game is on the props board while it has at least one market there: it enters with its first and leaves with its last. It is always on the Pre-game board as well, under the same evt_.
  • A market is in one product only. The same game's main lines are in pregame; nothing is duplicated.
  • Once the game starts, its props continue in Live.

Typical use

  • Player props tab: GET /v1/props/events/{eventId}?groups=player, or the stream with products=props&groups=player.
  • A whole pre-game card: take both products (products=pregame,props) and merge the two copies of each event by evt_: the event's fields are the same, the markets complement each other.

Grading props

Player props need the player's statistics and, for some types, whether he played. Verdicts on them may come later than the game's lines: a boxscore can come later than the score. For a soccer player's goals and cards, check gradedLeaguesBySport before relying on our verdict in a league (Where we grade). The rules are in Player props.

Combine it with

  • Pre-game: the main lines of the same games.
  • Live: the same games in play, props included.
  • Scores: the boxscore, the timeline and the lineups, to settle props yourself.
  • Grading: our verdict on each props selection, with GET /v1/props/grading.