Coverage
Leagues
Section titled “Leagues”| Dataset | Leagues |
|---|---|
| closing-lines | MLB, NBA, NHL, NFL, NCAAM |
| market-results | MLB, NBA, NHL, NFL, NCAAM |
| sportsbook-lines | MLB, NBA, NHL, NFL, NCAAM |
| game-state-timeline | MLB, NBA, NHL, NFL |
GET /v1/datasets reports the authoritative league list per dataset.
NCAAM market-results files are available with beta grading limits: MSF provides
box-score facts but no play-by-play. Some questions can be answered from the
final score or box-score totals; missing facts and unsupported questions remain
INDETERMINATE. Availability does not promise a decisive grade for every row
or verification of every sportsbook settlement rule. See
market-results grading semantics.
game-state-timeline excludes NCAAM because its state reconstruction library
does not support the league. Requests for an uncovered dataset/league return
404 with reason league_not_covered, even if a stored or cached file exists.
Operators
Section titled “Operators”Line data covers the major US books — FanDuel, DraftKings, BetMGM, Caesars,
and Pinnacle. Each row carries its operator code; filter locally (or with
the CLI/SDK --operator flag).
Market types
Section titled “Market types”Full-game and period spreads, moneylines, and totals, plus player props
(PLAYER_METRIC_OVER_UNDER and friends) where books offer them. The
market_type column is an open enum — enumerate the values present in your
files rather than assuming a fixed list
(/v1/datasets/{name}/schema documents the column). sportsbook-lines also
carries the operator’s raw vocabulary (operator_market_type) alongside the
classification.
Grain and file sizes
Section titled “Grain and file sizes”| Dataset | Rows / game (typ.) | Notes |
|---|---|---|
| closing-lines | ≈ 12,000 | One row per (operator, market, selection id, side) |
| market-results | ≈ 12,000 | One row per graded (operator, market, selection) |
| sportsbook-lines | ≈ 190,000 | Every change-only observation; ~20–35 MB Parquet |
| game-state-timeline | small | One row per state observation |
Quota is metered as rows downloaded, so these numbers are also the price of fetching a game — see Rate limits & quotas.
History depth
Section titled “History depth”How far back you can fetch depends on your subscription tier, enforced
per game against the game’s date; the DEMO tier is pinned to a fixed sample
month. Fetching a history-sensitive dataset for a game beyond your tier’s
window returns a 403 with problem type
history-restricted —
never silently clamped or empty data. game-state-timeline is exempt.
Coverage begins in 2026 and grows forward continuously (plus backfills as
they land) — pull /v1/games for a league and early date range to see the
earliest available games, and expect the newest datasets to have artifacts
for recent games first as the backfill proceeds.