statusId (fixture / future lifecycle)
The lifecycle of every fixture and future. Frozen set:
Notes:
statusNameis the translated display label (follows the language prefix);statusIdis the stable key — always branch on the ID.- Status only ever moves forward (
0 → 1 → 2, any state →3, any state →4); it never goes backwards. 3vs4.cancelledis a real event that will not be played — called off, abandoned, postponed indefinitely.removedmeans the entity should never have existed: a provider-side duplicate, a test entry, an event that was not real. Nothing was called off.4outranks3. Any state can move to4, including3, and4is terminal — once an entity isremovedit stays removed. Treat it as final and stop polling it. Scores and settlement are never published for a4.
period
Score, stats, and market data are keyed by a generic period vocabulary, so the same keys work across all sports. What a period means depends on the sport’s structure — use the fixture’sexpectedPeriods and periodLength to interpret it (e.g. p1 is a half in soccer, a quarter in NBA basketball, a set in tennis, a map in esports).
Whole-match keys
Numbered periods
Combined segments
Sums of consecutive periods, used where markets are offered on a combined segment:Sub-period keys (grids within a period)
Sub-period keys follow one shape:p{X}{axis}{Y} — unit Y within period X. Three axes exist today, and one of them nests a second level.
The period vocabulary is append-only: new sports may introduce additional keys, and new axes may join
g, r
and o (darts legs are a likely next one). Never hard-code an exhaustive list — handle unknown period keys
gracefully. Parsing structurally is safer than matching a fixed set of strings — but note that an axis may nest a
second level, as cricket’s b does inside o, so match the axes you know rather than assuming a single
p{X}{axis}{Y} shape.settlementStatus
Per-outcome grading returned by the settlement endpoints:
For non-clean grades (
CANCELLED / UNDECIDED) the settlement row carries a reason string explaining why.
Open taxonomies (not enums)
These vocabularies are string sets that grow over time — stable per value, but never exhaustive:marketType— market kind (1x2,totals,spreads,players-shots, …). See Concepts → Markets.eventType— in-play action types on the events channel (goal,card_yellow,corner_taken,substitution,var, …).statType— countable stat aggregates on the stats channel (score,corners,cards,aces, …).