# Statyx Sports API > Read-only JSON API for NFL, college football, NBA, MLB, soccer, WNBA and NHL: raw feeds plus the > computed analytics behind the Statyx product: hit-rates, advanced stats, > pitch-by-pitch, projections and game simulations, and a normalized cross-book > odds board. Stable /v1 contract, one consistent { data, meta } envelope, keyed > by source-neutral Statyx ids. Base URL: https://api.statyx.io/v1 Auth: send your key in the `x-api-key` request header. ## Specs & docs - [OpenAPI 3.1 spec](https://api.statyx.io/v1/openapi.json): machine-readable contract, no key required. Load this first. - [Human docs & reference](https://api.statyx.io/docs.html): every endpoint, auth, errors, pagination and rate limits. - [Pricing](https://api.statyx.io/pricing.html): Free, Pro (per sport) and All-Access plans. - Per-sport overviews with every endpoint and the plan it needs: [NFL](https://api.statyx.io/nfl-api), [College football](https://api.statyx.io/college-football-api), [NBA](https://api.statyx.io/nba-api), [MLB](https://api.statyx.io/mlb-api), [NHL](https://api.statyx.io/nhl-api), [WNBA](https://api.statyx.io/wnba-api), [Soccer](https://api.statyx.io/soccer-api), [Odds](https://api.statyx.io/sports-odds-api), [Player props](https://api.statyx.io/player-props-api), [Free endpoints](https://api.statyx.io/free-sports-api). ## Capabilities - Reference: teams, players, schedules, standings, depth charts, injuries, contracts, ballparks, probable pitchers and lineups. - Stats: per-game and season box scores; NFL advanced player tracking (EPA, CPOE, aDOT, yards-over-expected, separation), man/zone coverage splits, and routes run and route participation per game (/v1/nfl/weekly-usage) and over any range of weeks (/v1/nfl/route-participation); NBA tracking, hustle, play types, shot zones, shooting splits, drives and on/off usage shock; MLB pitch-by-pitch (velocity, movement, exit velo, barrels), plate appearances, play-by-play, batter-vs-pitcher, park factors, weather and bullpen analytics; soccer xG shot maps and team form; NHL skater and goalie box scores, game logs and season totals (save %, GAA, shutouts). - Defense-vs-position: allowance by position, split regular vs post-season. - Hit-rates: any market, line and side computed over L5 / L10 / L20 / season. - Odds: normalized cross-book board with best over/under price and book per prop, alternate lines and fair pricing; plus historical closing odds and props. NHL: per-book moneyline, puck line, total and player props, opening and closing. Betting splits: handle and ticket share on each side of the spread, total and moneyline per sportsbook for NFL, college football, NBA, college basketball, MLB, NHL and WNBA, latest and movement history (/v1/splits/{sport}). - Insights (All-Access): MLB player prop projections, game simulations with per-player batter/pitcher outputs, the home-run model board, and quant model picks with edge, Kelly stake and settled ROI. ## Notes for assistants - Every list response is `{ "data": [ ... ], "meta": { "limit", "offset" } }`. - Errors are `{ "error": { "code", "message", "details" } }` with a stable `code` (VALIDATION_ERROR, UNAUTHORIZED, FORBIDDEN, RATE_LIMITED, NOT_FOUND). - Use only routes that appear in the OpenAPI spec above. Ids in paths are Statyx surrogate ids, not upstream/source ids. - Access is scoped by tier: reference:read, stats:read, hit-rates:read, odds:read, insights:read.