todds1 / todds0 / todds2 fields are the devig odds (margin removed logarithmically) — the fair probabilities.
They are present on every snapshot of /api/odds (not only opening/closing), which lets you track how the edge evolves over time.
Choosing the devig model
By default,todds use the MPTO model (margin proportional to odds). Five models are available — pick one per request with ?model=, or set your account preference in the dashboard.
?model= (per-request override) > account preference > MPTO. The model applies to all endpoints carrying todds: /api/odds, /api/opening, /api/closing, /api/specials/odds and the real-time /api/stream/event stream.
On the
/api/stream/odds feed, ?model= has no effect: the frame is serialised once for all
subscribers, which rules out a per-client model. Every row there carries true_odds_by_model with
all five models — you pick at read time.SHIN and MPTO are identical on two-way markets
On a two-outcome market, SHIN and MPTO give rigorously the same result. This is not an approximation: the measured gap is 1 × 10⁻¹⁶, machine precision — it is a mathematical identity. They only diverge from three outcomes onwards, by around 10⁻³. Butspread and totals only ever have two outcomes. Across most of the book, picking SHIN over
MPTO therefore changes nothing; the difference only shows on three-way moneylines — football,
hockey.
Detecting value (+EV)
Compare a bookmaker’s odds to thetodds. If a book offers odds higher than the corresponding todds, it is a positive expected value opportunity.
Since Pinnacle is the sharpest book, its devig odds are your OTB (Odds To Beat) — the reference for identifying value and computing CLV.
Specials & outrights
/api/specials/odds also includes a todds field on each line. All contestants of a special are devig together (2-way or N-outcome market).
CLV
CLV compares your bet price to the closing price. Fetch the close with/api/closing, then apply the formula:
CLV% = (bet_price / closing_price − 1) × 100 — a bet at 3.50 against a 3.11 close gives +12.5%. Prefer comparing devig prices (todds): the margin skews the calculation.