Skip to main content
Version: main

MBB — Bart Torvik T-Rank (barttorvik.com)

sportsdataverse.mbb — 2 endpoints.

torvik_ratings

GET /{year}_team_results.csv — men's T-Rank team ratings (adjoe/adjde/barthag, one row per team; the team/conf pair feeds the MBB crosswalk).

Endpoint URL: GET https://barttorvik.com/{year}_team_results.csv

Valid URL: https://barttorvik.com/2025_team_results.csv

API ParameterPythonPatternRequiredNullableDescription
yearyearYyear path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
rankintegerT-Rank position (overall barthag rank).
teamcharacterTorvik team name (the crosswalk join key).
confcharacterTorvik conference abbreviation (e.g. B12, ACC, BE).
recordcharacterOverall win-loss record to date.
adjoenumericAdjusted offensive efficiency (points per 100 possessions vs an average defense).
oe_rankintegerNational rank of adjusted offensive efficiency.
adjdenumericAdjusted defensive efficiency (points allowed per 100 possessions vs an average offense).
de_rankintegerNational rank of adjusted defensive efficiency.
barthagnumericTorvik power rating: win probability vs an average team on a neutral floor.
rank_2integerBarthag rank repeated as shipped in the source CSV (duplicate of rank).
proj_wnumericProjected full-season wins.
proj_lnumericProjected full-season losses.
pro_con_wnumericProjected conference wins.
pro_con_lnumericProjected conference losses.
con_reccharacterConference win-loss record to date.
sosnumericStrength of schedule faced to date.
ncsosnumericNon-conference strength of schedule.
consosnumericConference strength of schedule.
proj_sosnumericProjected full-season strength of schedule.
proj_noncon_sosnumericProjected non-conference strength of schedule.
proj_con_sosnumericProjected conference strength of schedule.
elite_sosnumericElite strength of schedule (share of schedule vs elite opponents).
elite_noncon_sosnumericElite non-conference strength of schedule.
opp_oenumericAverage opponent offensive efficiency.
opp_denumericAverage opponent defensive efficiency.
opp_proj_oenumericProjected average opponent offensive efficiency.
opp_proj_denumericProjected average opponent defensive efficiency.
con_adj_oenumericAdjusted offensive efficiency in conference games only.
con_adj_denumericAdjusted defensive efficiency in conference games only.
qual_onumericOffensive efficiency vs quality (top-tier) opponents.
qual_dnumericDefensive efficiency vs quality (top-tier) opponents.
qual_barthagnumericBarthag computed from the quality-opponent efficiency splits.
qual_gamesnumericNumber of quality games underlying the qual_* splits.
funnumericTorvik's FUN style/entertainment index.
con_pfnumericPoints scored in conference play.
con_panumericPoints allowed in conference play.
con_possnumericPossessions played in conference play.
con_oenumericRaw offensive efficiency in conference play.
con_denumericRaw defensive efficiency in conference play.
con_sos_remainnumericStrength of the remaining conference schedule.
conf_win_percentnumericConference win percentage.
wabnumericWins above bubble (resume quality vs a bubble-level team).
wab_rkintegerNational rank of wins above bubble.
fun_rkintegerNational rank of the FUN index.
adjtnumericAdjusted tempo (possessions per 40 minutes).

return_parsed=False — the raw CSV response body (str).

Example

torvik_ratings(year=2025)

Last validated n/a.

torvik_team_factors

GET /{year}_fffinal.csv — men's four-factors splits (eFG%/FTR/OR%/TO% offense + defense, with per-stat ranks).

Endpoint URL: GET https://barttorvik.com/{year}_fffinal.csv

Valid URL: https://barttorvik.com/2025_fffinal.csv

API ParameterPythonPatternRequiredNullableDescription
yearyearYyear path parameter.

Returns

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
team_namecharacterTorvik team name.
e_fg_percentnumericEffective field-goal percentage on offense.
rkintegerNational rank of offensive eFG%.
e_fg_percent_defnumericEffective field-goal percentage allowed on defense.
rk_2integerNational rank of defensive eFG% allowed.
ftrnumericFree-throw rate on offense (FTA per FGA).
rk_3integerNational rank of offensive free-throw rate.
ftr_defnumericFree-throw rate allowed on defense.
rk_4integerNational rank of defensive free-throw rate allowed.
or_percentnumericOffensive rebound percentage.
rk_5integerNational rank of offensive rebound percentage.
dr_percentnumericDefensive rebound percentage.
rk_6integerNational rank of defensive rebound percentage.
to_percentnumericTurnover percentage on offense.
rk_7integerNational rank of offensive turnover percentage.
to_percent_defnumericTurnover percentage forced on defense.
rk_8integerNational rank of defensive turnover percentage forced.
x3p_percentnumericThree-point percentage on offense.
rk_9integerNational rank of offensive three-point percentage.
x3p_d_percentnumericThree-point percentage allowed on defense.
rk_10integerNational rank of three-point percentage allowed.
x2p_percentnumericTwo-point percentage on offense.
rk_11integerNational rank of offensive two-point percentage.
x2p_percent_dnumericTwo-point percentage allowed on defense.
rk_12integerNational rank of two-point percentage allowed.
ft_percentnumericFree-throw percentage.
rk_13integerNational rank of free-throw percentage.
ft_percent_dnumericOpponent free-throw percentage.
rk_14integerNational rank of opponent free-throw percentage.
x3p_ratenumericThree-point attempt rate on offense (3PA per FGA).
rk_15integerNational rank of offensive three-point attempt rate.
x3p_rate_dnumericThree-point attempt rate allowed on defense.
rk_16integerNational rank of three-point attempt rate allowed.
aratenumericAssist rate on offense (assists per made field goal).
rk_17integerNational rank of offensive assist rate.
arate_dnumericAssist rate allowed on defense.
rk_18integerNational rank of assist rate allowed.
unnamednumericHeaderless trailing column shipped in the source CSV (undocumented upstream).
unnamed_2integerHeaderless trailing column shipped in the source CSV (undocumented upstream).
unnamed_3numericHeaderless trailing column shipped in the source CSV (undocumented upstream).
unnamed_4integerHeaderless trailing column shipped in the source CSV (undocumented upstream).

return_parsed=False — the raw CSV response body (str).

Example

torvik_team_factors(year=2025)

Last validated n/a.