odds

Historical odds snapshots for a match (CLV)

Every historical odds snapshot (opening / t24h / closing, never the live current series) for one match, newest snapshot first, with sportsbook names resolved. Powers closing-line value (CLV) and line-movement analysis. Requires an Edge plan or higher (Free / Solo / Trio receive 403). Each row carries an EVIDENCE-BASED verification field from two-source cross-checking: a "verified" status is only ever returned when we actually compared two providers, never inferred from the absence of a check: two_source_agreed (both providers priced this book/market/side and agreed; a positive comparison is on record), two_source_diverged (both priced it and disagreed; divergence_categories then lists the categories, e.g. ["PRICE_DIFF","STALE"]), single_source (only one provider carries this book/side, or the book has no cross-provider match; NOT verified), or unverified (we have not compared this line; NOT verified). The default when we lack evidence is single_source or unverified, never a badge. verified_at dates the comparison the status came from (null when nothing was compared); a verification you cannot date is a claim you cannot check. A comparison only describes the snapshot whose line it actually compared and only within 48h of it, so a snapshot whose price has since moved reads unverified rather than inheriting an older badge. Response: { data: [{ match_id, snapshot_type, snapshot_at, market, book: { id, name, logo_url }, line, source, fetched_at, verification, verified_at, divergence_categories? }], meta: { total, limit, offset, snapshot_types_present, generated_at } }.

get/v1/odds/historical

Request

  • Base URL: https://api.bigballsdata.com
  • URL: https://api.bigballsdata.com/v1/odds/historical
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Query parameters

match_idstring uuid required

Match to read snapshots for.

snapshot_type'opening' | 't24h' | 'closing'

Filter to one snapshot type (default: all historical).

sportsbookstring

Filter to one book by the name returned in book.name, e.g. DraftKings. Case-insensitive.

marketstring

Filter to one market, e.g. moneyline.

limitinteger
offsetinteger

Response

ok

object required

Changes

No recorded changes to this operation across all 3 revisions of this API.