---
title: "GET /odds/history"
method: GET
path: "/odds/history"
tags: ["Prices"]
---

# GET /odds/history

`GET /odds/history`

## Request

- Base URL: `https://api.sockodds.com/v1`
- URL: `https://api.sockodds.com/v1/odds/history`
- Auth: HTTP bearer

Pro and Internal only. Own observations recorded under the new identities only. No observation predates 22 December 2025 UTC. Changes older than the live store keeps are read from the daily history archive and returned in the same shape and order, so a window reads the same whichever store holds it. Changes are ordered by observation time, then by when they were recorded. A window may not exceed 24 hours. While older history is busy the API answers 503 with a short Retry-After.

## Query parameters

- `event_id` string, required
- `from` string, date-time, required
- `to` string, date-time, required
- `markets` string
- `bookmakers` string
- `cursor` string
- `limit` integer

## Response `200`

Historical changes

- HistoryEnvelope
  - `data` HistoryChange[], required
    - `event` string, required
    - `market` RecordedMarket, required
      - `id` string, required
      - `key` string, required
      - `name` string, required
      - `period` string, required
      - `subject` union, required
        - NamedKey
          - `key` string, required
          - `name` string, required
        - object
          - `id` string, required
          - `name` string, required
    - `outcome` object, required
      - `id` string, required
      - `name` string, required
      - `side` string, required
    - `bookmaker` string, required
    - `observed_at` string, date-time, required
    - `kind` 'opened' | 'changed' | 'withdrawn', required
    - `decimal_odds` number, nullable, required
    - `implied_probability` number, nullable
    - `line` number, nullable
  - `meta` Meta, required
    - `count` integer, required
    - `cursor` string, nullable, required
  - `links` Links, required
    - `next` string, uri-reference, nullable, required

## Other responses

- `default`: Request failed

---

[API](https://skmtc.dev/sockodds/apis/sockodds-api.md) · [All operations](https://skmtc.dev/sockodds/apis/sockodds-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sockodds/apis/sockodds-api/revisions/f4c680d355be?raw)