Skip to main content

torvik — native provider reference

  • namespace: sdv.torvik (standalone — not an ESPN league)
  • families: BartTorvik (T-Rank)
  • wrappers: 5 native

torvik is a Basketball provider namespace (no ESPN {sport}/{league} nesting). Every method is exposed under BOTH its snake_case name (<family>_<endpoint>, py/R parity) and a camelCase canonical name (<family><Endpoint>) on sdv.torvik. Pass { parsed: true } to any endpoint to get tidy rows instead of raw JSON.

import sdv from 'sportsdataverse';

// BartTorvik T-Rank is keyless (a browser User-Agent is set for you).
// `year` is the 4-digit season ending-year:
await sdv.torvik.torvik_ratings({ year: 2024, parsed: true });

Native API — BartTorvik (T-Rank)

Flat (non-ESPN) wrappers for barttorvik.com (T-Rank college basketball analytics). Host: https://barttorvik.com. Each method is exposed under BOTH torvik_<endpoint> (snake_case, py/R parity) and torvik<Endpoint> (camelCase canonical) on sdv.torvik. Pass { parsed: true } to run the payload through its tidy.js parser; omit it for the raw response.

MethodHTTPPath paramsQuery paramsParserAuth
torvik_game_schedule / torvikGameSchedulehttps://barttorvik.com/{year}_super_sked.jsonyear*parse_torvik_game_schedule
torvik_game_stats / torvikGameStatshttps://barttorvik.com/getgamestats.phpyear, jsonparse_torvik_game_stats
torvik_player_stats / torvikPlayerStatshttps://barttorvik.com/getadvstats.phpyear, csvparse_torvik_player_stats
torvik_ratings / torvikRatingshttps://barttorvik.com/{year}_team_results.csvyear*parse_torvik_ratings
torvik_team_factors / torvikTeamFactorshttps://barttorvik.com/{year}_fffinal.csvyear*parse_torvik_team_factors

Returns — torvik_game_schedule / torvikGameSchedule

col_nametypedescription
muidcharacterMatchup unique id.
datecharacterGame date (M/D/YY).
conmatchcharacterConference matchup descriptor.
matchupcharacterRanked-matchup descriptor.
predictioncharacterPre-game prediction (favorite, score, win %).
ttqnumericTorvik Thrill Quotient (game excitement).
confintegerConference-game flag.
venueintegerVenue / neutral-site flag.
team1characterTeam 1.
t1oenumericTeam 1 offensive efficiency in the game.
t1denumericTeam 1 defensive efficiency in the game.
t1pynumericTeam 1 pre-game win probability (pythag).
t1wpintegerTeam 1 win flag (1 if won).
t1proptnumericTeam 1 projected points.
team2characterTeam 2.
t2oenumericTeam 2 offensive efficiency in the game.
t2denumericTeam 2 defensive efficiency in the game.
t2pynumericTeam 2 pre-game win probability (pythag).
t2wpintegerTeam 2 win flag (1 if won).
t2proptnumericTeam 2 projected points.
tpronumericProjected total points.
t1qualcharacterTeam 1 game-quality descriptor.
t2qualcharacterTeam 2 game-quality descriptor.
gpintegerGame-played flag (1 if completed).
resultcharacterFinal result string.
temponumericGame tempo (possessions).
possessionsnumericPossessions in the game.
t1ptsintegerTeam 1 points.
t2ptsintegerTeam 2 points.
winnercharacterWinning team.
losercharacterLosing team.
t1adjtnumericTeam 1 adjusted tempo.
t2adjtnumericTeam 2 adjusted tempo.
t1adjonumericTeam 1 adjusted offensive efficiency.
t1adjdnumericTeam 1 adjusted defensive efficiency.
t2adjonumericTeam 2 adjusted offensive efficiency.
t2adjdnumericTeam 2 adjusted defensive efficiency.
gamevaluenumericGame quality value.
mismatchnumericMismatch rating (predicted lopsidedness).
blowoutnumericBlowout rating.
t1elitenumericTeam 1 elite-performance rating.
t2elitenumericTeam 2 elite-performance rating.
ord_dateintegerOrdinal date (sortable day index).
t1pppnumericTeam 1 points per possession.
t2pppnumericTeam 2 points per possession.
gamepppnumericCombined game points per possession.
t1rkintegerTeam 1 T-Rank at game time.
t2rkintegerTeam 2 T-Rank at game time.
t1gsnumericTeam 1 single-game quality score.
t2gsnumericTeam 2 single-game quality score.
gamestatscharacterNested per-game stat array (;-joined).
overtimescharacterNumber of overtimes.
t1funnumericTeam 1 fun rating.
t2funnumericTeam 2 fun rating.
resultscharacterPost-game results descriptor.

Returns — torvik_game_stats / torvikGameStats

col_nametypedescription
datecharacterGame date (M/D/YY).
typeintegerGame-type flag.
teamcharacterTeam name.
confcharacterTeam conference.
oppcharacterOpponent.
venuecharacterVenue (H/A/N).
resultcharacterResult string.
adj_oenumericAdjusted offensive efficiency.
adj_denumericAdjusted defensive efficiency.
oenumericRaw offensive efficiency (points/100 poss).
off_efgnumericOffensive effective FG%.
off_tonumericOffensive turnover %.
off_ornumericOffensive rebound %.
off_ftrnumericOffensive free-throw rate.
denumericRaw defensive efficiency (points allowed/100 poss).
def_efgnumericDefensive effective FG% allowed.
def_tonumericDefensive turnover % forced.
def_ornumericDefensive (opponent) rebound %.
def_ftrnumericDefensive free-throw rate allowed.
game_scorenumericBart Torvik single-game quality score.
opp_confcharacterOpponent conference.
quadintegerNCAA quadrant (1-4) of the game.
yearintegerSeason (4-digit ending-year).
temponumericGame tempo (possessions).
muidcharacterMatchup unique id.
coachcharacterTeam head coach.
opp_coachcharacterOpponent head coach.
marginnumericFinal scoring margin.
win_probnumericPre-game win probability.
game_statscharacterNested per-game stat array (;-joined).
overtimesintegerNumber of overtimes.

Returns — torvik_player_stats / torvikPlayerStats

col_nametypedescription
player_namecharacterPlayer name.
teamcharacterTeam name.
confcharacterConference.
gamesintegerGames played.
min_pctnumericPercentage of available minutes played.
o_rtgnumericOffensive rating.
usagenumericUsage rate.
e_fgnumericEffective FG%.
ts_pctnumericTrue shooting %.
orb_pctintegerOffensive rebound %.
drb_pctnumericDefensive rebound %.
ast_pctnumericAssist %.
to_pctnumericTurnover %.
ftmintegerFree throws made.
ftaintegerFree throws attempted.
ft_pctnumericFree-throw %.
two_pmintegerTwo-point field goals made.
two_paintegerTwo-point field goals attempted.
two_p_pctnumericTwo-point FG%.
three_pmintegerThree-point field goals made.
three_paintegerThree-point field goals attempted.
three_p_pctintegerThree-point FG%.
blk_pctintegerBlock %.
stl_pctintegerSteal %.
ftrnumericFree-throw rate.
classcharacterClass (Fr/So/Jr/Sr).
heightcharacterListed height.
numberintegerJersey number.
porpagnumericPoints over replacement per adjusted game.
adj_oenumericAdjusted offensive efficiency.
pfrnumericPersonal foul rate.
yearintegerSeason (4-digit ending-year).
player_idintegerBart Torvik player id.
hometowncharacterPlayer hometown.
rec_ranknumericRecruiting rank.
ast_tonumericAssist-to-turnover ratio.
rim_madeintegerField goals made at the rim.
rim_attemptsintegerField goals attempted at the rim.
mid_madeintegerMid-range field goals made.
mid_attemptsintegerMid-range field goals attempted.
rim_pctnumericField goal % at the rim.
mid_pctnumericMid-range field goal %.
dunks_madeintegerDunks made.
dunks_attemptsintegerDunks attempted.
dunks_pctnumericDunk %.
pickcharacterNBA draft pick (if drafted).
drtgnumericDefensive rating.
adrtgnumericAdjusted defensive rating.
dporpagnumericDefensive points over replacement per adjusted game.
stopsnumericDefensive stops.
bpmnumericBox plus/minus.
obpmnumericOffensive box plus/minus.
dbpmnumericDefensive box plus/minus.
gbpmnumericTorvik (game-based) box plus/minus.
minutesnumericMinutes played.
ogbpmnumericOffensive Torvik box plus/minus.
dgbpmnumericDefensive Torvik box plus/minus.
orebnumericOffensive rebounds per game.
drebnumericDefensive rebounds per game.
trebnumericTotal rebounds per game.
astnumericAssists per game.
stlnumericSteals per game.
blknumericBlocks per game.
ptsnumericPoints per game.
rolecharacterBart Torvik player role/position label.
threatnumericOffensive threat rating.
recruit_datecharacterRecruiting commitment date.

Returns — torvik_ratings / torvikRatings

col_nametypedescription
rankintegerOverall T-Rank (barthag) rank.
teamcharacterTeam name.
confcharacterConference.
recordcharacterOverall record.
adjoenumericAdjusted offensive efficiency.
oe_rankintegerNational rank of adjusted offensive efficiency.
adjdenumericAdjusted defensive efficiency.
de_rankintegerNational rank of adjusted defensive efficiency.
barthagnumericPower rating (win prob vs average).
rank_1integerInterspersed secondary rank column.
proj_wnumericProjected wins.
proj_lnumericProjected losses.
pro_con_wnumericProjected conference wins.
pro_con_lnumericProjected conference losses.
con_reccharacterConference record.
sosnumericStrength of schedule.
ncsosnumericNon-conference strength of schedule.
consosnumericConference strength of schedule.
proj_sosnumericProjected strength of schedule.
proj_noncon_sosnumericProjected non-conference strength of schedule.
proj_con_sosnumericProjected conference strength of schedule.
elite_sosnumericStrength of schedule against elite teams.
elite_noncon_sosnumericNon-conference strength of schedule against elite teams.
opp_oenumericAverage opponent offensive efficiency.
opp_denumericAverage opponent defensive efficiency.
opp_proj_oenumericAverage projected opponent offensive efficiency.
opp_proj_denumericAverage projected opponent defensive efficiency.
con_adj_oenumericConference-only adjusted offensive efficiency.
con_adj_denumericConference-only adjusted defensive efficiency.
qual_onumericQuality-adjusted offensive efficiency.
qual_dnumericQuality-adjusted defensive efficiency.
qual_barthagnumericQuality-adjusted power rating.
qual_gamesnumericNumber of quality games played.
funnumericFun rating (entertainment value).
con_pfnumericConference points scored.
con_panumericConference points allowed.
con_possnumericConference possessions.
con_oenumericConference offensive efficiency.
con_denumericConference defensive efficiency.
con_sosremainnumericRemaining conference strength of schedule.
conf_win_percentnumericConference win percentage.
wabnumericWins above bubble.
wab_rkintegerNational rank of wins above bubble.
fun_rkintegerNational rank of fun rating.
adjtnumericAdjusted tempo.

Returns — torvik_team_factors / torvikTeamFactors

col_nametypedescription
team_namecharacterTeam name.
e_fg_percentnumericEffective FG% (offense).
rkintegerNational rank of effective FG% (offense).
e_fg_percent_defnumericEffective FG% allowed (defense).
rk_1integerNational rank of effective FG% allowed (defense).
ftrnumericFree-throw rate (offense).
rk_2integerNational rank of free-throw rate (offense).
ftr_defnumericFree-throw rate allowed (defense).
rk_3integerNational rank of free-throw rate allowed (defense).
or_percentnumericOffensive rebound %.
rk_4integerNational rank of offensive rebound %.
dr_percentnumericDefensive rebound %.
rk_5integerNational rank of defensive rebound %.
to_percentnumericTurnover % (offense).
rk_6integerNational rank of turnover % (offense).
to_percent_defnumericTurnover % forced (defense).
rk_7integerNational rank of turnover % forced (defense).
3_p_percentnumericThree-point % (offense).
3p_d_percentnumericThree-point % allowed (defense).
2p_percentnumericTwo-point % (offense).
2p_percent_dnumericTwo-point % allowed (defense).
ft_percentnumericFree-throw % (offense).
ft_percent_dnumericFree-throw % allowed (defense).
3_p_ratenumericThree-point attempt rate (offense).
3_p_rate_dnumericThree-point attempt rate allowed (defense).
aratenumericAssist rate (offense).
rk_8integerNational rank of assist rate (offense).
arate_dnumericAssist rate allowed (defense).
rk_9integerNational rank of assist rate allowed (defense).
parsed_extracharacterTrailing unmapped CSV fields (overflow), if any.