Fine Print Analytics
NBA Fine Print API Live on RapidAPI

Analytics data
for the edge-seekers.

Professional-grade NBA analytics built for developers, quantitative bettors, and model builders. Referee ATS splits, pace profiles, travel burden, timezone lag, player streaks, and more. 3+ seasons of history. Updated daily at 10am ET.

3+
Seasons of History
99.8%
ATS Coverage
18
Endpoints
10am
Daily Update ET

Getting Started

01
Authentication
All endpoints require an X-RapidAPI-Key header. Subscribe to any plan on RapidAPI to receive your key.
02
Default Behavior
All endpoints default to the current season. Pass ?season=2024 for historical data. Historical access requires Ultra tier.
03
Team IDs
All team_id parameters use Basketball Reference abbreviations. See the full list below. Example: DET, LAL, BOS.
04
Data Freshness
Game results, ATS outcomes, referee assignments, and player stats updated daily at 10am ET. Real-time data is not available.

Plans

Basic
Free
100 calls / month
  • Team win/loss records
  • Game pace & possession data
  • Rest days & back-to-back flags
  • All-time head-to-head records
  • Current season only
Ultra
$99/mo
10,000 calls / month
  • Everything in Pro
  • Game ATS results back to 2023
  • Altitude fatigue per game & player
  • Team rolling averages — last 5 & 10 games
  • Team win/loss streaks
  • Player rolling averages — pts/reb/ast
  • Player hot/cold streaks
  • Player performance splits by referee
  • Historical seasons 2023–2026

Team IDs

All team_id parameters use Basketball Reference abbreviations.
ATL BOS BRK CHO CHI CLE DAL DEN DET GSW HOU IND LAC LAL MEM MIA MIL MIN NOP NYK OKC ORL PHI PHO POR SAC SAS TOR UTA WAS

Basic Endpoints — Free

Get Team Records
GET/v1/teams/record
Basic · Free
Returns team win/loss records by season, including home record, away record, and overall win percentage. Defaults to the current season.
Use Case

Quickly assess how a team performs at home vs on the road before evaluating a spread.

Parameters
NameTypeExampleDescription
team_idstringDETBasketball Reference abbreviation. Optional.
seasonnumber2026Season year. Defaults to current.
Get Team Pace
GET/v1/teams/pace
Basic · Free
Returns game pace and possession data by team, including average possessions per game and pace ranking relative to the league.
Use Case

When a high-pace team plays a slow defensive team, the total line often doesn't fully account for pace suppression.

Parameters
NameTypeExampleDescription
team_idstringDETBasketball Reference abbreviation. Required.
seasonnumber2026Season year. Defaults to current.
game_datestring2026-03-17Filter to a specific game date.
Get Team Rest
GET/v1/teams/rest
Basic · Free
Returns rest days and back-to-back flags per game by team. Includes days since last game for both home and away teams.
Use Case

Systematically identify back-to-back disadvantages across the full slate rather than manually checking schedules.

Parameters
NameTypeExampleDescription
team_idstringDETBasketball Reference abbreviation. Required.
seasonnumber2026Season year. Defaults to current.
game_datestring2026-03-17Filter to a specific game date.
Get Head to Head
GET/v1/teams/head-to-head
Basic · Free
Returns all-time head-to-head record between two teams across all available seasons.
Use Case

Pull historical head-to-head records to identify persistent matchup tendencies the market underweights.

Parameters
NameTypeExampleDescription
team_astringDETFirst team abbreviation. Required.
team_bstringLALSecond team abbreviation. Required.

Pro Endpoints — $49/mo

Get Referee Tendencies
GET/v1/referees/tendencies
Pro
Returns historical referee game tendencies including average pace, total fouls called, free throw rate, and home team win percentage.
Use Case

Pull tonight's referee assignments and factor their home win tendencies into your model before the line moves.

Parameters
NameTypeExampleDescription
referee_namestringScott FosterFull referee name. Optional.
min_gamesnumber20Minimum games officiated. Defaults to 20.
Get Referee ATS
GET/v1/referees/ats
Pro
Returns historical ATS and over/under splits for each referee, including home team ATS percentage, over percentage, and average ATS margin.
Use Case

A referee with a 61% over rate across 200+ games reflects their foul-calling style inflating scoring through free throws.

Parameters
NameTypeExampleDescription
referee_namestringScott FosterFull referee name. Optional.
min_gamesstring20Minimum games threshold. Defaults to 20.
Get Team Referee Record
GET/v1/teams/referee-record
Pro
Returns a team's win/loss record split by individual referee. Surfaces which officials a specific team consistently performs well or poorly with.
Use Case

Query DET with Scott Foster and see Detroit's historical record when he's officiating.

Parameters
NameTypeExampleDescription
team_idstringDETBasketball Reference abbreviation. Required.
referee_namestringScott FosterFilter to a specific referee. Optional.
Get Team Referee ATS
GET/v1/teams/referee-ats
Pro
Returns a team's ATS record and over/under splits broken down by referee.
Use Case

If LAL covers at 65% when a specific official is assigned to their home games, build a lookup table of team/referee ATS combinations.

Parameters
NameTypeExampleDescription
team_idstringDETBasketball Reference abbreviation. Required.
referee_namestringScott FosterFilter to a specific referee. Optional.
Get Travel Data
GET/v1/games/travel
Pro
Returns travel distance and direction per game for both home and away teams, including miles traveled and whether the team crossed significant time zones.
Use Case

Stack travel distance with rest data and timezone lag to identify multi-dimensional structural disadvantages.

Parameters
NameTypeExampleDescription
team_idstringDETBasketball Reference abbreviation. Required.
seasonnumber2026Season year. Defaults to current.
game_datestring2026-03-17Filter to a specific game date.
Get Timezone Lag
GET/v1/games/timezone-lag
Pro
Returns timezone shift data per game including home and away team timezone changes from their previous game location and overall lag advantage score.
Use Case

A West Coast team playing a 1pm ET road game on the East Coast is essentially playing at 10am their body time.

Parameters
NameTypeExampleDescription
team_idstringDETBasketball Reference abbreviation. Required.
seasonnumber2026Season year. Defaults to current.
game_datestring2026-03-17Filter to a specific game date.

Ultra Endpoints — $99/mo

Get Game ATS Results
GET/v1/games/ats
Ultra
Returns game against-the-spread results including home line, over/under, ATS result, and line source. Covers 3+ seasons with 99.8% ATS coverage.
Use Case

Build a backtest: pull all games where a West team traveled east on a back-to-back and measure historical cover rate.

Parameters
NameTypeExampleDescription
team_idstringDETFilter to a specific team. Optional.
seasonnumber2026Season year. Historical requires Ultra.
game_datestring2026-03-17Filter to a specific date.
Get Altitude Fatigue
GET/v1/games/altitude-fatigue
Ultra
Returns altitude fatigue data per game including arena altitude, the away team's previous game altitude, and the altitude change they're experiencing.
Use Case

Identify the highest altitude-change spots and factor physiological disadvantage into your totals model.

Parameters
NameTypeExampleDescription
team_idstringDETFilter to a specific team. Required.
seasonnumber2026Season year. Defaults to current.
game_datestring2026-03-17Filter to a specific date.
Get Team Streaks
GET/v1/teams/streaks
Ultra
Returns team win/loss streak data with streak length and streak label by game.
Use Case

A team on a 7-game winning streak gets inflated public betting action. Use streak data to identify when the market has overreacted to momentum.

Parameters
NameTypeExampleDescription
team_idstringDETBasketball Reference abbreviation. Required.
seasonnumber2026Season year. Defaults to current.
Get Team Rolling Averages
GET/v1/teams/rolling-averages
Ultra
Returns rolling averages for team stats including points scored, points allowed, win percentage, and pace over the last 5 and 10 games.
Use Case

Compare both teams' last-5-game points allowed averages to build a dynamic total estimate against the posted line.

Parameters
NameTypeExampleDescription
team_idstringDETBasketball Reference abbreviation. Required.
seasonnumber2026Season year. Defaults to current.
game_datestring2026-03-17Rolling averages as of this date.
Get Player Streak
GET/v1/players/streaks
Ultra
Returns player hot/cold streak data including points above or below their season average over the last 3 and 5 games.
Use Case

Flag players 5+ points above or below their average and compare against posted prop lines for market inefficiency.

Parameters
NameTypeExampleDescription
player_namestringCade CunninghamFull player name. Required.
team_idstringDETTeam abbreviation. Required.
seasonnumber2026Season year. Defaults to current.
Get Player Rolling Averages
GET/v1/players/rolling-averages
Ultra
Returns rolling averages for player stats including points, rebounds, and assists over the last 3 and 5 games, compared against their season average.
Use Case

Pull last-3 and last-5 rolling averages across all three categories to identify reliable same-game parlay legs.

Parameters
NameTypeExampleDescription
player_namestringCade CunninghamFull player name. Required.
team_idstringDETTeam abbreviation. Required.
seasonnumber2026Season year. Defaults to current.
game_datestring2026-03-17Rolling averages as of this date.
Get Player Referee Stats
GET/v1/players/referee-stats
Ultra
Returns player performance splits by referee, including average points, season average comparison, and plus/minus with that official.
Use Case

If a player averages 28 points with a specific referee but 21 with others, the prop line set on his season average represents a measurable edge.

Parameters
NameTypeExampleDescription
player_namestringCade CunninghamFull player name. Required.
team_idstringDETTeam abbreviation. Required.
referee_namestringScott FosterFilter to a specific referee. Optional.
min_gamesnumber5Minimum games with this referee. Defaults to 10.
Get Player Altitude Fatigue
GET/v1/players/altitude-fatigue
Ultra
Returns player performance data broken down by quarter in altitude games, including stats and altitude change from their previous game location.
Use Case

Pull quarter splits in altitude games before betting first-half player props in Denver or Salt Lake City.

Parameters
NameTypeExampleDescription
player_namestringCade CunninghamFull player name. Required.
team_idstringDETTeam abbreviation. Required.
seasonnumber2026Season year. Defaults to current.
game_datestring2026-03-17Filter to a specific game date.

Notes & Defaults

Referee Filters
Referee endpoints default to officials with 20+ games. Pass min_games=1 to include all referees regardless of sample size.
Player Filters
Player/referee endpoints default to a minimum of 10 games together. Use min_games=1 to see all combinations including small samples.
Historical Access
Historical seasons 2023–2025 require Ultra tier. Pass ?season=2023 through ?season=2025 for historical data.
Data Coverage
3+ complete NBA seasons (2023–2026). 99.8% ATS coverage. All referee data joined to named referees. Updated daily at 10am ET.

Ready to build?

Start free with 100 calls per month. No credit card required.