Get Historical Odds

Get historical odds at a point in time.

Credits: 10 × billable markets × regions. This archive holds moneyline, spread and total columns and nothing else, so h2h, spreads and totals are the only keys that can be billed here. outrights, the alt ladder and every prop key are accepted, return nothing from this archive, cost zero, and come back named in x-markets-unservable with the archive endpoint that does hold them in x-markets-served-elsewhere (prop history is /v1/historical/sports/{sport_key}/closing-odds?markets=<key>; period history is /v1/historical/sports/{sport_key}/period_markets).

iter_058 #463 — date= vs dateFrom=&dateTo= return different rows for the same date. The single-date path (?date=YYYY-MM-DD) reads from the long-term archive and includes the _an "anchored" closing-line variants (e.g. draftkings_an, fanduel_an, bet365_an) alongside the regular bookmaker rows. The range path (?dateFrom=...&dateTo=...) reads from the rolling snapshot table and surfaces only the bare bookmaker keys (without _an). For consistent backtest joins, prefer ?date= when you need closing-line anchors. See /v1/bookmakers/{key}.historical_variants for the suffix convention.

date omitted returns the latest snapshot (equivalent to current /v1/sports/{sport_key}/odds but routed through the historical pricing). This matches the UX of /closing-odds which doesn't require an explicit date either - removes the 422-on-missing-param trap that customers hit when they don't read the schema first.