Skip to content

Changelog

Changes to the Lineval API contract, newest first.

Versioning

  • Within v1 nothing is removed or renamed, and no field changes meaning. A new version only adds: products, fields, catalog ids, message types, error codes, held reasons.
  • Ignore what you do not know: a field, a catalog id, a message type. Your integration keeps working as the API grows.
  • Anything we retire is announced 90 days ahead, here, and goes only with a new major version.
  • Grading rules are versioned on their own (rules in every grading). A new version of the rules is announced here, with what it changes.

1.0.0 (unreleased)

The first version of the contract.

Model and conventions - One model for every product: events, participants, markets and selections; status of a market or selection is open, suspended or closed. - Opaque, stable ids: evt_, mkt_, sel_, par_, lg_ and bk_. A game keeps its evt_ in every product, from before its start to after its end. - Prices as {decimal, american}. Times in ISO 8601 UTC with milliseconds. camelCase field names; every field always present (null when unknown). - home and away are the teams' real roles in every product; home and away selections carry their team's par_. - Event.rotation ({away, home, draw, official, added}) and Event.schedule ({originalStartAt, startAt, timeConfirmed}). - Market.book ({id, name}) and Selection.opening ({line, price, at}): sportsbooks' lines with their opening and closing lines, next to our own (book: null). A book's main market keeps its id while its line moves; when the books' lines cannot be kept current, only the books' markets are suspended. A game only the books list is an event of its own.

Products - pregame: a game's main lines before it starts (moneyline, match_result, double_chance, draw_no_bet, spread, asian_handicap, set_spread, total, total_sets, team_total), for the whole game and each period, with alternate lines; ours and the sportsbooks'. - props: every other market of a game before it starts, under the same evt_. - live: every market of a game in play, props included, with score and clock; ours and the sportsbooks'. - futures: markets on a whole competition. - scores: the live board and the scoresheet of every game (status, score, periods, regulation time, team statistics, timeline, boxscore, lineups, confidence, revisions and corrections). - grading: our verdict on every selection of our own lines in live, pregame and props, by the rules 2026-11, as an add-on to those products. - racing: horse, harness and greyhound racing: race cards, pari-mutuel pools and official results with their dividends.

REST - GET /v1/{product}/events, /v1/{product}/events/{eventId} (filters periods, marketTypes, groups, with an ETag), /v1/events/{eventId} (a game across products). - GET /v1/scores, /v1/scores/{eventId} (with confidence=confirmed: only confirmed scoresheets). - GET /v1/{product}/grading, /v1/{product}/grading/{eventId}. - Catalogs: sports, leagues, periods, market-types (with form, group, gradedPeriodsBySport and gradedLeaguesBySport), market-groups, stat-keys, books. - GET /v1/health: whether the API is serving; with a key, the state of its products. - Filters sports and leagues (sport and league accepted too); from, to and updatedSince in ISO 8601 with their zone, or a date. - A weak ETag on every data and catalog 200, and gzip from 1 KB. - One error format: {"error": {"code", "message", "requestId"}}.

Stream - One WebSocket for every product: {type, seq, ts, product, data}; a snapshot, then deltas. - Resume with since per product, on any server. - scoresheet.withdrawn: a confirmed scoresheet is no longer confirmed. - Every close code with what to do; reconnect after every close except 4400, 4401 and 4403.