Get Consensus
Get consensus (average) odds across all bookmakers. 3 credits.
Returns the average odds, best odds, worst odds, and hold/vig for each market across all bookmakers. Useful for identifying where your book stands vs the market.
The average is taken in probability space: each book's American price is converted to its implied probability, those are averaged into consensus_prob, and consensus_odds is that probability converted back. Averaging American prices directly is invalid because the scale jumps across zero, so +150 and -150 would average to 0 rather than to even money.
iter_058 #462: prediction markets are excluded from the rollup by default. Kalshi was producing wildly off prices like +3233 for 'Phillies win' that turned out to reference a different market (e.g. series winner, not next game ML) and skewed consensus_odds to nonsense values. Use ?include_prediction_markets=true to restore the prior behavior of mixing them in.
Request
- Base URL: https://parlay-api.com
- URL: https://parlay-api.com/v1/sports/{sport_key}/consensus
- Auth: one of:
- API key in header X-API-Key
- API key in query parameter apiKey
- HTTP bearer
Path parameters
Query parameters
Include Kalshi/Polymarket prices in the consensus rollup. Defaults to False because prediction markets often price derivative questions (e.g. 'Phillies win series') that look like h2h ML but skew the average. Set true if you specifically want their prices mixed in.
CSV of bookmaker keys to include in the rollup. Omit to include all books for the sport. iter_060 #465.
CSV of bookmaker keys to include in the rollup. Omit to include all books for the sport. iter_060 #465. Repeating this parameter is the same as the comma form: ?markets=h2h&markets=spreads and ?markets=h2h,spreads are one request, billed identically, and return the union. A value repeated across occurrences is counted once.
CSV of market_keys to filter to (e.g. h2h,player_points)
CSV of market_keys to filter to (e.g. h2h,player_points) Repeating this parameter is the same as the comma form: ?markets=h2h&markets=spreads and ?markets=h2h,spreads are one request, billed identically, and return the union. A value repeated across occurrences is counted once.
Response
Successful Response
Changes
No recorded changes to this operation across all 1 revision of this API.