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
propsboard 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 sameevt_. - 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 withproducts=props&groups=player. - A whole pre-game card: take both products (
products=pregame,props) and merge the two copies of each event byevt_: 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.