stat-api — Sports Data

Tools

Token cost is the o200k count of the tools list JSON, including schemas, before any tool is called.

• list_leagues

  List every league/data group this API serves (nfl, nba, mlb, nhl, pga, dfs, reference) with table counts and availability. No credentials needed. Start here, then call list_tables.

• list_tables

  List every queryable table in one league with a one-line summary each. No credentials needed. Follow with describe_table before querying.

• describe_table

  Full contract for one table: fields with types and descriptions, the filters query_table accepts (with operators like __gte/__lte/__between/__like and required filter combinations), page-size limits,

• query_table

  Query any table. Returns `{"<table>": [rows], "limit": N, "next_from_id": M|null, "has_more": bool}`. To read every row, start with from_id=0 and re-call with from_id set to the previous next_from_id

• get_record

  Fetch a single row by primary key. Returns the row object. Requires an API key; costs 1 record of quota.

• search_players

  Fuzzy player-name search (typo-tolerant). Currently NBA only — for other leagues query the players table with a name filter via query_table. Returns player rows ordered by match quality. Requires an A

• games_on_date

  Games scheduled/played on one calendar date (US-Eastern) for nba, mlb, or nhl; defaults to today. Returns the same envelope as query_table on the games table. NFL is week-based, not date-based — for n

• graphql_query

  Run a GraphQL query against the same data with relations — nest from a game to its teams/players/odds in one call. Root fields are leagues (nfl, nba, …), each exposing its tables with the same filter

• api_usage

  Your key's quota position: plan, monthly record limit, records used, remaining, and when the quota resets. Requires an API key; costs 1 record.