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.
| Method | HTTP | Path params | Query params | Parser | Auth |
|---|---|---|---|---|---|
torvik_game_schedule / torvikGameSchedule | https://barttorvik.com/{year}_super_sked.json | year* | — | parse_torvik_game_schedule | — |
torvik_game_stats / torvikGameStats | https://barttorvik.com/getgamestats.php | — | year, json | parse_torvik_game_stats | — |
torvik_player_stats / torvikPlayerStats | https://barttorvik.com/getadvstats.php | — | year, csv | parse_torvik_player_stats | — |
torvik_ratings / torvikRatings | https://barttorvik.com/{year}_team_results.csv | year* | — | parse_torvik_ratings | — |
torvik_team_factors / torvikTeamFactors | https://barttorvik.com/{year}_fffinal.csv | year* | — | parse_torvik_team_factors | — |
Returns — torvik_game_schedule / torvikGameSchedule
| col_name | type | description |
|---|---|---|
muid | character | Matchup unique id. |
date | character | Game date (M/D/YY). |
conmatch | character | Conference matchup descriptor. |
matchup | character | Ranked-matchup descriptor. |
prediction | character | Pre-game prediction (favorite, score, win %). |
ttq | numeric | Torvik Thrill Quotient (game excitement). |
conf | integer | Conference-game flag. |
venue | integer | Venue / neutral-site flag. |
team1 | character | Team 1. |
t1oe | numeric | Team 1 offensive efficiency in the game. |
t1de | numeric | Team 1 defensive efficiency in the game. |
t1py | numeric | Team 1 pre-game win probability (pythag). |
t1wp | integer | Team 1 win flag (1 if won). |
t1propt | numeric | Team 1 projected points. |
team2 | character | Team 2. |
t2oe | numeric | Team 2 offensive efficiency in the game. |
t2de | numeric | Team 2 defensive efficiency in the game. |
t2py | numeric | Team 2 pre-game win probability (pythag). |
t2wp | integer | Team 2 win flag (1 if won). |
t2propt | numeric | Team 2 projected points. |
tpro | numeric | Projected total points. |
t1qual | character | Team 1 game-quality descriptor. |
t2qual | character | Team 2 game-quality descriptor. |
gp | integer | Game-played flag (1 if completed). |
result | character | Final result string. |
tempo | numeric | Game tempo (possessions). |
possessions | numeric | Possessions in the game. |
t1pts | integer | Team 1 points. |
t2pts | integer | Team 2 points. |
winner | character | Winning team. |
loser | character | Losing team. |
t1adjt | numeric | Team 1 adjusted tempo. |
t2adjt | numeric | Team 2 adjusted tempo. |
t1adjo | numeric | Team 1 adjusted offensive efficiency. |
t1adjd | numeric | Team 1 adjusted defensive efficiency. |
t2adjo | numeric | Team 2 adjusted offensive efficiency. |
t2adjd | numeric | Team 2 adjusted defensive efficiency. |
gamevalue | numeric | Game quality value. |
mismatch | numeric | Mismatch rating (predicted lopsidedness). |
blowout | numeric | Blowout rating. |
t1elite | numeric | Team 1 elite-performance rating. |
t2elite | numeric | Team 2 elite-performance rating. |
ord_date | integer | Ordinal date (sortable day index). |
t1ppp | numeric | Team 1 points per possession. |
t2ppp | numeric | Team 2 points per possession. |
gameppp | numeric | Combined game points per possession. |
t1rk | integer | Team 1 T-Rank at game time. |
t2rk | integer | Team 2 T-Rank at game time. |
t1gs | numeric | Team 1 single-game quality score. |
t2gs | numeric | Team 2 single-game quality score. |
gamestats | character | Nested per-game stat array (;-joined). |
overtimes | character | Number of overtimes. |
t1fun | numeric | Team 1 fun rating. |
t2fun | numeric | Team 2 fun rating. |
results | character | Post-game results descriptor. |
Returns — torvik_game_stats / torvikGameStats
| col_name | type | description |
|---|---|---|
date | character | Game date (M/D/YY). |
type | integer | Game-type flag. |
team | character | Team name. |
conf | character | Team conference. |
opp | character | Opponent. |
venue | character | Venue (H/A/N). |
result | character | Result string. |
adj_oe | numeric | Adjusted offensive efficiency. |
adj_de | numeric | Adjusted defensive efficiency. |
oe | numeric | Raw offensive efficiency (points/100 poss). |
off_efg | numeric | Offensive effective FG%. |
off_to | numeric | Offensive turnover %. |
off_or | numeric | Offensive rebound %. |
off_ftr | numeric | Offensive free-throw rate. |
de | numeric | Raw defensive efficiency (points allowed/100 poss). |
def_efg | numeric | Defensive effective FG% allowed. |
def_to | numeric | Defensive turnover % forced. |
def_or | numeric | Defensive (opponent) rebound %. |
def_ftr | numeric | Defensive free-throw rate allowed. |
game_score | numeric | Bart Torvik single-game quality score. |
opp_conf | character | Opponent conference. |
quad | integer | NCAA quadrant (1-4) of the game. |
year | integer | Season (4-digit ending-year). |
tempo | numeric | Game tempo (possessions). |
muid | character | Matchup unique id. |
coach | character | Team head coach. |
opp_coach | character | Opponent head coach. |
margin | numeric | Final scoring margin. |
win_prob | numeric | Pre-game win probability. |
game_stats | character | Nested per-game stat array (;-joined). |
overtimes | integer | Number of overtimes. |
Returns — torvik_player_stats / torvikPlayerStats
| col_name | type | description |
|---|---|---|
player_name | character | Player name. |
team | character | Team name. |
conf | character | Conference. |
games | integer | Games played. |
min_pct | numeric | Percentage of available minutes played. |
o_rtg | numeric | Offensive rating. |
usage | numeric | Usage rate. |
e_fg | numeric | Effective FG%. |
ts_pct | numeric | True shooting %. |
orb_pct | integer | Offensive rebound %. |
drb_pct | numeric | Defensive rebound %. |
ast_pct | numeric | Assist %. |
to_pct | numeric | Turnover %. |
ftm | integer | Free throws made. |
fta | integer | Free throws attempted. |
ft_pct | numeric | Free-throw %. |
two_pm | integer | Two-point field goals made. |
two_pa | integer | Two-point field goals attempted. |
two_p_pct | numeric | Two-point FG%. |
three_pm | integer | Three-point field goals made. |
three_pa | integer | Three-point field goals attempted. |
three_p_pct | integer | Three-point FG%. |
blk_pct | integer | Block %. |
stl_pct | integer | Steal %. |
ftr | numeric | Free-throw rate. |
class | character | Class (Fr/So/Jr/Sr). |
height | character | Listed height. |
number | integer | Jersey number. |
porpag | numeric | Points over replacement per adjusted game. |
adj_oe | numeric | Adjusted offensive efficiency. |
pfr | numeric | Personal foul rate. |
year | integer | Season (4-digit ending-year). |
player_id | integer | Bart Torvik player id. |
hometown | character | Player hometown. |
rec_rank | numeric | Recruiting rank. |
ast_to | numeric | Assist-to-turnover ratio. |
rim_made | integer | Field goals made at the rim. |
rim_attempts | integer | Field goals attempted at the rim. |
mid_made | integer | Mid-range field goals made. |
mid_attempts | integer | Mid-range field goals attempted. |
rim_pct | numeric | Field goal % at the rim. |
mid_pct | numeric | Mid-range field goal %. |
dunks_made | integer | Dunks made. |
dunks_attempts | integer | Dunks attempted. |
dunks_pct | numeric | Dunk %. |
pick | character | NBA draft pick (if drafted). |
drtg | numeric | Defensive rating. |
adrtg | numeric | Adjusted defensive rating. |
dporpag | numeric | Defensive points over replacement per adjusted game. |
stops | numeric | Defensive stops. |
bpm | numeric | Box plus/minus. |
obpm | numeric | Offensive box plus/minus. |
dbpm | numeric | Defensive box plus/minus. |
gbpm | numeric | Torvik (game-based) box plus/minus. |
minutes | numeric | Minutes played. |
ogbpm | numeric | Offensive Torvik box plus/minus. |
dgbpm | numeric | Defensive Torvik box plus/minus. |
oreb | numeric | Offensive rebounds per game. |
dreb | numeric | Defensive rebounds per game. |
treb | numeric | Total rebounds per game. |
ast | numeric | Assists per game. |
stl | numeric | Steals per game. |
blk | numeric | Blocks per game. |
pts | numeric | Points per game. |
role | character | Bart Torvik player role/position label. |
threat | numeric | Offensive threat rating. |
recruit_date | character | Recruiting commitment date. |
Returns — torvik_ratings / torvikRatings
| col_name | type | description |
|---|---|---|
rank | integer | Overall T-Rank (barthag) rank. |
team | character | Team name. |
conf | character | Conference. |
record | character | Overall record. |
adjoe | numeric | Adjusted offensive efficiency. |
oe_rank | integer | National rank of adjusted offensive efficiency. |
adjde | numeric | Adjusted defensive efficiency. |
de_rank | integer | National rank of adjusted defensive efficiency. |
barthag | numeric | Power rating (win prob vs average). |
rank_1 | integer | Interspersed secondary rank column. |
proj_w | numeric | Projected wins. |
proj_l | numeric | Projected losses. |
pro_con_w | numeric | Projected conference wins. |
pro_con_l | numeric | Projected conference losses. |
con_rec | character | Conference record. |
sos | numeric | Strength of schedule. |
ncsos | numeric | Non-conference strength of schedule. |
consos | numeric | Conference strength of schedule. |
proj_sos | numeric | Projected strength of schedule. |
proj_noncon_sos | numeric | Projected non-conference strength of schedule. |
proj_con_sos | numeric | Projected conference strength of schedule. |
elite_sos | numeric | Strength of schedule against elite teams. |
elite_noncon_sos | numeric | Non-conference strength of schedule against elite teams. |
opp_oe | numeric | Average opponent offensive efficiency. |
opp_de | numeric | Average opponent defensive efficiency. |
opp_proj_oe | numeric | Average projected opponent offensive efficiency. |
opp_proj_de | numeric | Average projected opponent defensive efficiency. |
con_adj_oe | numeric | Conference-only adjusted offensive efficiency. |
con_adj_de | numeric | Conference-only adjusted defensive efficiency. |
qual_o | numeric | Quality-adjusted offensive efficiency. |
qual_d | numeric | Quality-adjusted defensive efficiency. |
qual_barthag | numeric | Quality-adjusted power rating. |
qual_games | numeric | Number of quality games played. |
fun | numeric | Fun rating (entertainment value). |
con_pf | numeric | Conference points scored. |
con_pa | numeric | Conference points allowed. |
con_poss | numeric | Conference possessions. |
con_oe | numeric | Conference offensive efficiency. |
con_de | numeric | Conference defensive efficiency. |
con_sosremain | numeric | Remaining conference strength of schedule. |
conf_win_percent | numeric | Conference win percentage. |
wab | numeric | Wins above bubble. |
wab_rk | integer | National rank of wins above bubble. |
fun_rk | integer | National rank of fun rating. |
adjt | numeric | Adjusted tempo. |
Returns — torvik_team_factors / torvikTeamFactors
| col_name | type | description |
|---|---|---|
team_name | character | Team name. |
e_fg_percent | numeric | Effective FG% (offense). |
rk | integer | National rank of effective FG% (offense). |
e_fg_percent_def | numeric | Effective FG% allowed (defense). |
rk_1 | integer | National rank of effective FG% allowed (defense). |
ftr | numeric | Free-throw rate (offense). |
rk_2 | integer | National rank of free-throw rate (offense). |
ftr_def | numeric | Free-throw rate allowed (defense). |
rk_3 | integer | National rank of free-throw rate allowed (defense). |
or_percent | numeric | Offensive rebound %. |
rk_4 | integer | National rank of offensive rebound %. |
dr_percent | numeric | Defensive rebound %. |
rk_5 | integer | National rank of defensive rebound %. |
to_percent | numeric | Turnover % (offense). |
rk_6 | integer | National rank of turnover % (offense). |
to_percent_def | numeric | Turnover % forced (defense). |
rk_7 | integer | National rank of turnover % forced (defense). |
3_p_percent | numeric | Three-point % (offense). |
3p_d_percent | numeric | Three-point % allowed (defense). |
2p_percent | numeric | Two-point % (offense). |
2p_percent_d | numeric | Two-point % allowed (defense). |
ft_percent | numeric | Free-throw % (offense). |
ft_percent_d | numeric | Free-throw % allowed (defense). |
3_p_rate | numeric | Three-point attempt rate (offense). |
3_p_rate_d | numeric | Three-point attempt rate allowed (defense). |
arate | numeric | Assist rate (offense). |
rk_8 | integer | National rank of assist rate (offense). |
arate_d | numeric | Assist rate allowed (defense). |
rk_9 | integer | National rank of assist rate allowed (defense). |
parsed_extra | character | Trailing unmapped CSV fields (overflow), if any. |