SplitsResponse

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/owlsinsight-com/json-schema/owlsinsight-com-splits-response-schema.json",
  "title": "SplitsResponse",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/owlsinsight-com-openapi.json#/components/schemas/SplitsResponse",
  "properties": {
    "data": {
      "items": {
        "$ref": "#/$defs/SplitsGame"
      },
      "type": "array"
    },
    "meta": {
      "properties": {
        "age_seconds": {
          "description": "Only when `status` is 'stale': how old the served board is, in seconds.",
          "format": "double",
          "type": "number"
        },
        "as_of": {
          "description": "ISO time of the OLDEST of the books' latest reads behind this board, so it never\noverstates freshness. Each split also carries its own {@link SplitsBookEntry.as_of};\na DraftKings split kept after kickoff has an older one than this.\nSince API v2.362.0.",
          "type": "string"
        },
        "books": {
          "description": "The books on this board: 'draftkings', 'betmgm' and, while it is offered, 'circa'.\nCan be `['draftkings']` alone. (Each split's own `book` key is 'dk', 'betmgm' or\n'circa'.) Read the book set from here, never from a fixed list: books are added.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "partial_reason": {
          "description": "Only when `status` is 'partial': 'upstream_limited' = the Circa figures were withheld;\n'book_unavailable' = one book has no recent read (that book is missing from `books`);\n'upstream_paused' = no board at all is available: no book could be read and no board\nfrom the last 12 hours exists (`data` is empty).",
          "type": "string",
          "x-extensible-enum": [
            "book_unavailable",
            "upstream_limited",
            "upstream_paused"
          ]
        },
        "source": {
          "description": "A fixed legacy value, 'circa_dk', whatever books are on the board. Do not read\nthe book set from it: use `books`.",
          "type": "string"
        },
        "status": {
          "description": "'ok' = every book on offer has a recent read. 'partial' = one does not (see\n`partial_reason`), so `data` may be a subset. 'stale' = no book has a recent read,\nand the last full board (at most 12 hours old, see `as_of` / `age_seconds`) is\nserved instead.\nAbsent on API versions before v2.346.0; 'stale' since v2.362.0.",
          "type": "string",
          "x-extensible-enum": [
            "ok",
            "partial",
            "stale"
          ]
        },
        "total_games": {
          "description": "Number of games in `data`. Present on every response since API v2.346.0 (earlier: only on cache misses).",
          "format": "double",
          "type": "number"
        }
      },
      "type": "object",
      "x-owls-required": [
        "source",
        "books"
      ]
    },
    "sport": {
      "type": "string"
    }
  },
  "type": "object",
  "x-owls-required": [
    "sport",
    "data",
    "meta"
  ],
  "$defs": {
    "SplitsBookEntry": {
      "description": "One book's figures for a game. A market the book has not published for the game is\nabsent, not zero, and so is any percentage a book does not publish: BetMGM publishes\nticket percentages only, so a `betmgm` entry carries the `*_bets_pct` fields and no\n`*_handle_pct` fields. Treat every field below `book`/`title` as possibly absent.",
      "properties": {
        "as_of": {
          "description": "ISO 8601 time this book's figures were read. The books are read on different\nschedules, so two books on one game can show different times. DraftKings figures\nrun until kickoff; the last pre-game DraftKings figures stay on the board for up to\n4 hours after kickoff, with the `as_of` of that last read.\nAbsent on responses from before 2026-09-27.",
          "type": "string"
        },
        "book": {
          "description": "Book key: 'dk' (DraftKings), 'betmgm' (BetMGM, tickets only, since 2026-09-29) or\n'circa' (Circa Sports). Other keys may appear as books are added.",
          "type": "string"
        },
        "moneyline": {
          "properties": {
            "away_bets_pct": {
              "format": "double",
              "type": "number"
            },
            "away_handle_pct": {
              "format": "double",
              "type": "number"
            },
            "away_price": {
              "format": "double",
              "type": "number"
            },
            "home_bets_pct": {
              "format": "double",
              "type": "number"
            },
            "home_handle_pct": {
              "format": "double",
              "type": "number"
            },
            "home_price": {
              "format": "double",
              "type": "number"
            }
          },
          "type": "object"
        },
        "spread": {
          "properties": {
            "away_bets_pct": {
              "format": "double",
              "type": "number"
            },
            "away_handle_pct": {
              "format": "double",
              "type": "number"
            },
            "away_line": {
              "format": "double",
              "type": "number"
            },
            "home_bets_pct": {
              "format": "double",
              "type": "number"
            },
            "home_handle_pct": {
              "format": "double",
              "type": "number"
            },
            "home_line": {
              "format": "double",
              "type": "number"
            }
          },
          "type": "object"
        },
        "title": {
          "description": "Display name: 'DraftKings', 'BetMGM' or 'Circa Sports'.",
          "type": "string"
        },
        "total": {
          "properties": {
            "line": {
              "format": "double",
              "type": "number"
            },
            "over_bets_pct": {
              "format": "double",
              "type": "number"
            },
            "over_handle_pct": {
              "format": "double",
              "type": "number"
            },
            "under_bets_pct": {
              "format": "double",
              "type": "number"
            },
            "under_handle_pct": {
              "format": "double",
              "type": "number"
            }
          },
          "type": "object"
        }
      },
      "type": "object",
      "x-owls-required": [
        "book",
        "title"
      ]
    },
    "SplitsGame": {
      "properties": {
        "away_team": {
          "description": "The /odds team name (same string as {@link OddsEvent.away_team}).",
          "type": "string"
        },
        "event_id": {
          "description": "Our event id: the {@link OddsEvent.eventId} that `/api/v1/{sport}/odds` gives the\nsame game, `{sport}:{Away}@{Home}-{YYYYMMDD}` (e.g.\n\"nfl:Carolina Panthers@Cleveland Browns-20260927\"), so splits join to odds on it.\nThe date is the game's UTC start date, except MLB games starting from\n2026-10-11T10:00Z, which carry the US Eastern date (as on /odds). A game not on\n/odds gets an id built the same way from its scheduled start. Both games of a\ndoubleheader share one `event_id`, as on /odds.\n\nBefore 2026-09-27 this was an upstream game code (e.g. \"20260622MLB00030\") that did\nnot match /odds.",
          "type": "string"
        },
        "home_team": {
          "description": "The /odds team name (same string as {@link OddsEvent.home_team}).",
          "type": "string"
        },
        "splits": {
          "items": {
            "$ref": "#/$defs/SplitsBookEntry"
          },
          "type": "array"
        }
      },
      "type": "object",
      "x-owls-required": [
        "event_id",
        "home_team",
        "away_team",
        "splits"
      ]
    }
  }
}