---
title: "Returns the movement history of betting splits: the recorded readings of the handle (money) percent and ticket (bet) percent on each side of the spread, the total and the moneyline of a game, per book, with the line or price shown at that moment."
method: GET
path: "/api/v1/history/splits"
tags: ["Historical data"]
---

# Returns the movement history of betting splits: the recorded readings of the handle (money) percent and ticket (bet) percent on each side of the spread, the total and the moneyline of a game, per book, with the line or price shown at that moment.

`GET /api/v1/history/splits`

## Request

- Base URL: `https://api.owlsinsight.com`
- URL: `https://api.owlsinsight.com/api/v1/history/splits`
- Auth: HTTP bearer

Returns the movement history of betting splits: the recorded readings of the handle (money) percent and ticket (bet) percent on each side of the spread, the total and the moneyline of a game, per book, with the line or price shown at that moment.

Historical endpoints share a per-key in-flight limit that is lower than the general concurrent-request limit. A request beyond it returns 429 with a Retry-After header giving the delay in seconds; wait that long and resend.

503 with a Retry-After header means the archive could not serve that request: the query was too expensive to run in one request, or the archive read path was busy. Wait the indicated seconds before resending; if it repeats, narrow the request with the filters this endpoint accepts.

Page one event at a time with limit and offset and stop when a page comes back shorter than limit. Do not fan out one request per book or market in parallel.

Rows have the shape of the entries on /api/v1/{sport}/splits, oldest first, with recorded_at where the live board has as_of; a row is written when a book's figures (percentages, line or price) change, and again after 24 hours without a change, so consecutive rows for a game and book can carry the same figures. Either eventId or sport is required; with sport, startDate is required and the window is at most 7 days.

A market absent from a row was not quoted at that read; a percentage absent from a market (some books publish tickets only) is not zero.

## Query parameters

- `eventId` string
- `sport` string
- `book` string
- `startDate` string
- `endDate` string
- `limit` string
- `offset` string

## Response `200`

OK

- HistorySplitsResponse: Response for GET /api/v1/history/splits. Rows are oldest first.
  - `data` object
    - `eventId` string: Echoed when the request named an eventId.
    - `pagination` object
      - `hasMore` boolean
      - `limit` number, double
      - `offset` number, double
      - `total` number, double
    - `splits` SplitsHistoryRow[]
      - `book` string: Book key: 'dk', 'circa' or 'betmgm'.
      - `event_id` string: The game's /odds eventId, the same as {@link SplitsGame.event_id}.
      - `moneyline` object
        - `away_bets_pct` number, double
        - `away_handle_pct` number, double
        - `away_price` number, double
        - `home_bets_pct` number, double
        - `home_handle_pct` number, double
        - `home_price` number, double
      - `recorded_at` string: ISO 8601 time this reading was recorded.
      - `sport` string
      - `spread` object
        - `away_bets_pct` number, double
        - `away_handle_pct` number, double
        - `away_line` number, double
        - `home_bets_pct` number, double
        - `home_handle_pct` number, double
        - `home_line` number, double
      - `title` string: Display name: 'DraftKings', 'Circa Sports' or 'BetMGM'.
      - `total` object
        - `line` number, double
        - `over_bets_pct` number, double
        - `over_handle_pct` number, double
        - `under_bets_pct` number, double
        - `under_handle_pct` number, double
    - `sport` string: Echoed when the request named a sport.
    - `window` object: The UTC date window served (both ends inclusive), on a query by sport only.
      - `end` string
      - `start` string
  - `success` boolean

---

[API](https://skmtc.dev/owlsinsight/apis/owls-insight-api.md) · [All operations](https://skmtc.dev/owlsinsight/apis/owls-insight-api/llms.txt) · [OpenAPI document](https://skmtc.dev/owlsinsight/apis/owls-insight-api/revisions/76c1ea016ff1?raw)