History & Settlement Signals

Opening lines

Which bookmaker posted each market first, at what line and price, and when — read from a durable per-book ledger (sportquanta_ingestion.openingOdds), not derived from ClickHouse history. Unlike the current-odds and history endpoints, this does not age out: an opener recorded here survives the 13-month ClickHouse retention window that the odds-history endpoints are bounded by.

Coverage note: "first" means first among the bookmakers that were actively being scraped at the time. A book whose route was enabled after a market opened cannot win, and the response does not distinguish that from a book that genuinely posted later.

Requires the stats entitlement (a paid plan). See Responses & Errors for the success envelope and availability rules.

GEThttps://api.sportquanta.com/v1/{league}/games/{id}/odds/opening

Reference context: WKBL.

Overview · Response conventions

curl --request GET \
  --url 'https://api.sportquanta.com/v1/wkbl/games/{id}/odds/opening' \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "data": {
      "game_id": "<string>",
      "league": "<string>",
      "bookmakers": [
        "<string>"
      ],
      "markets": [
        {
          "market": "<string>",
          "period": "<string>",
          "selection": "<string>",
          "first_bookmaker": "<string>",
          "first_observed_at": "2026-10-29T00:00:00Z",
          "first_tied_with": [
            "<string>"
          ],
          "lead_seconds": 0,
          "book_count": 0,
          "books": [
            {
              "bookmaker": "<string>",
              "observed_at": "2026-10-29T00:00:00Z",
              "line": 0,
              "price_decimal": 0,
              "price_american": 0,
              "source_id": "<string>",
              "origin": "<string>",
              "recorded_at": "2026-10-29T00:00:00Z"
            }
          ]
        }
      ]
    }
  },
  "_meta": {
    "request_id": "REQUEST_ID",
    "served_from": "live",
    "cache_ttl_seconds": 300
  }
}

Authorizations

Authorizationstringheaderrequired

Send a workspace API token in the Authorization: Bearer <token> header.

Path Parameters

leagueenum<string>default:wkblrequired

League for this reference section: wkbl.

Available options: wkbl

idstringrequired

Query Parameters

bookmakerstring

Comma-separated bookmaker ids to include.

marketstring

Comma-separated market keys to include.

formatenum<string>default:american

Accepted format hint (american by default, or decimal). Current responses retain both explicitly named price fields when available; this parameter does not strip or synthesize prices. Closing consensus_price_decimal remains decimal.

Available options: decimal, american

Response

application/json

Opening line per market: the earliest bookmaker (with any tied bookmakers and the lead time to the next distinct observation), plus the full per-book ladder of opening observations.

dataobjectrequired

data.dataobjectrequired

data.data.game_idstringrequired

data.data.leaguestringrequired

data.data.bookmakersstring[] | nullrequired

data.data.marketsobject[] | nullrequired

data.data.markets.marketstringrequired

data.data.markets.periodstring

data.data.markets.selectionstringrequired

data.data.markets.first_bookmakerstringrequired

data.data.markets.first_observed_atstring<date-time>required

data.data.markets.first_tied_withstring[]

data.data.markets.lead_secondsnumber

data.data.markets.book_countintegerrequired

data.data.markets.booksobject[] | nullrequired

data.data.markets.books.bookmakerstringrequired

data.data.markets.books.observed_atstring<date-time>required

data.data.markets.books.linenumber

data.data.markets.books.price_decimalnumber

Decimal quoted odds, when available. Responses can retain both decimal and American prices; format is a hint and does not guarantee conversion or removal of the other field.

data.data.markets.books.price_americaninteger

American quoted odds, when available (for example -110 or +150). Responses can retain both price formats; format is a hint and does not guarantee conversion or removal of the other field.

data.data.markets.books.source_idstring

data.data.markets.books.originstring

data.data.markets.books.recorded_atstring<date-time>

_metaobject

Response request/cache metadata. Optional evidence fields are specific to this handler; cache TTL does not measure source-data freshness.

_meta.request_idstring

_meta.served_fromenum<string>

Available options: live, cache

_meta.cache_ttl_secondsinteger

Response cache TTL; independent of source freshness. Omitted when zero.