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

# Export Odds History

`GET /v1/exports/odds-history`

## Request

- Base URL: `https://api.prop-line.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.prop-line.com/v1/exports/odds-history`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in query parameter `apiKey`

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).

Enterprise only (since 2026-10-28). Other tiers get per-event
`/odds/history` and the resolved-props export (opening + closing
lines). Historical Backfill passes bought before 2026-10-28 keep
access until they expire (2-year lookback).

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.dev/prop-line/apis/player-props-api.md) - [All operations](https://skmtc.dev/prop-line/apis/player-props-api/llms.txt) - [OpenAPI document](https://skmtc.dev/prop-line/apis/player-props-api/revisions/d3654129ada4?raw)