---
title: "Export Odds History"
method: GET
path: "/v1/exports/odds-history"
tags: ["Exports"]
---

# Export Odds History

`GET /v1/exports/odds-history`

Stream the full line-movement time-series as CSV — every recorded odds
snapshot (price + point, per book) for every outcome, not just the
closing line. One row per (outcome, snapshot).

This is the raw tick history that **no subscription tier can pull in
bulk**: Pro/Streaming get per-event `/odds/history` and the
resolved-props export (closing line only), but the bulk snapshot
firehose is exclusive to the one-time Historical Backfill pass and
Enterprise. Backfill pass = trailing 2-year lookback (Enterprise
unbounded); uncapped calls.

A full all-sport, all-history pull is many GB — page month-by-month
with `since`/`until` to keep any single FILE a size you can handle.
(The DB side no longer needs the help: the export runs one short
statement per 6-hour slice regardless of the window you ask for.)

Archive coverage is stated in-band: `X-PropLine-Archive-Starts`
carries the sport's earliest recorded date (`none` if no data yet),
and `X-PropLine-Archive-Notice` is set when the requested window
ends before the archive begins, meaning the export can only be empty.

## Query parameters

- `sport` string, required — Sport key (e.g. baseball_mlb). Required.
- `market` string — Optional market filter, e.g. pitcher_strikeouts
- `bookmaker` string — Optional bookmaker filter
- `since` string, date-time, nullable — ISO datetime lower bound on recorded_at
- `until` string, date-time, nullable — ISO datetime upper bound on recorded_at

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/prop-line/apis/player-props-api.md) · [All operations](https://skmtc.net/prop-line/apis/player-props-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prop-line/player-props-api/revisions/e71139f4c7dc/schema)