The package's core types follow the IPTC Sport Schema, the RDF successor to SportsML. Betting odds have no open standard, so prices take The Odds API's shape. Everything can be exported as JSON-LD on the IPTC context.
Status and outcome codes are IPTC NewsCodes; statistics are keyed by IPTC Core Statistics and sport-module names, so a stat line means the same thing in every product.
| Package type | IPTC | Notes |
|---|---|---|
Competition, CompetitionPhase | spsch:Competition, spsch:CompetitionPhase | League, season, tournament, series or meet; phases nest. |
SportsEvent | spsch:Event | Status from speventstatus (pre-event, mid-event, post-event, postponed…); outcome from speventoutcome. |
Team, Athlete, Associate, Official | spsch:Team, spsch:Athlete, spsch:Associate, spsch:Official | Agents; membership links athletes and staff to teams. |
Membership | spsch:Membership | Roster entry with status, role and dates. |
Participation, ParticipationSplit | spsch:Participation | Alignment (home/away/neutral), score, outcome, rank, stat line. |
Site | spsch:Site | Venue with geography, capacity, surface. |
GameAction | spsch:Action | Play-by-play: period, clock, agent, result, points. |
StatKey, StatLine, Standing | spstat:*, spamfstat:*, spbkbstat:* … | Core and sport-module statistics; x: prefix for the gaps. |
Market, Outcome, BookmakerOdds | — | No open standard for prices; The Odds API's de facto shape. |
Three documents straight from the package: a final event with its venue, the top standing, and a team.
StratusSportsVocabulary, odds maths, parlays, standings, JSON-LD, provider protocols, prediction models, evaluator, value finder, wagers, grader, ledger, fantasy.
StratusSportsModels18 SS* Mongo records: sport, team, competition, athlete, site, event (with external ids), event link, odds snapshot, standing, prediction, rating, sync run, wager, player game stat, fantasy league/team/matchup/projection.
StratusSportsOddsAPIThe Odds API v4 client with quota headers and conformances to the provider protocols. The production data path.
StratusSportsESPNESPN's public site API, raw JSON: scoreboard, teams, summary. Development and backfill source.
StratusSportsNFLversenflverse's open NFL releases (CC-BY 4.0): weekly player and team box scores, the schedule with closing lines and ESPN/PFR ids, the player id crosswalk.
StratusSportsServerKitSync, query, rating, prediction, betting, fantasy and event-crosswalk services over Mongo; indexes; fingerprinted snapshots; props settle through the links.
StratusSportsTaskssports.sync, sports.stats and sports.models handlers for a project's StratusTasks worker, with a distributed lock.
The package is vendor-neutral by design. The catalog of every API, data release and SDK considered, with tiers, limits and adoption status, lives in the repo at Resources/API_AND_SDK.md.
| Source | Sports | Tier | Fit |
|---|---|---|---|
| The Odds API v4 | odds, all majors + soccer + MMA | free tier → paid | adopted: prices, scores, events |
| ESPN site API | NFL, NBA, MLB, NHL, NCAA, soccer | keyless, undocumented | scaffolded: development scores and box scores |
| nflverse | NFL | open data, CC-BY 4.0 | adopted: box scores, schedule, ids for the crosswalk |
| MLB Stats API | MLB | official, keyless | schedules, live box scores |
| NHL Web API | NHL | official, keyless | schedules, box scores, standings |
| Sleeper | NFL fantasy | free, non-commercial | player ids, injuries, trending |
| CollegeFootballData | NCAAF | free key | games, stats, lines |
| SportsDataIO, Goalserve, Sportradar | all majors | paid | if a product needs guaranteed uptime or official licensing |
Events carry their latest prices; snapshots carry the history, de-duplicated by fingerprint. Scores sync never regresses odds; odds sync never regresses status or scores.
Recurring work is a TaskHandler on a cron schedule in the project's worker, guarded by a Mongo distributed lock. Never EventBridge.
S3 + CloudFront with a pretty-URL edge function. swift run StratusSportsDemo writes data/site.json; the pages render it in the browser. Graphics were rendered with FLUX.1-schnell on the stratus-gpu box.