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 (
rulesin 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.