Fantasy Data

College Basketball Data Dictionary

The FantasyData College Basketball API has a new home over at SportsDataIO Discovery Lab, a platform built to offer affordable sports data for students, hobbyists and personal projects.

If you're looking for a more extensive product to power your website or application, we encourage you to check out SportsDataIO's commercial College Basketball API.

Below you will find a list of all data points that are contained within each feed that we offer. If any of the information provided below is unclear, or if you have a specific question, please contact support.

Go to our developer portal for a full list of operations including deprecated, legacy and test endpoints.

All dates & times are in US Eastern Time.

Choose League:

Expand All Collapse All Download CSV

Core

This table is used in the following endpoints:
FantasyData CBB Fantasy API
League Hierarchy
FantasyData CBB Odds API
League Hierarchy
Name Type Size Nullable Scrambled CSV Description
ConferenceID integer 32 No No Yes The ID of the team's conference
Name string 50 No No Yes The name of the team's conference
Teams Team[] Yes No Yes The college teams within this conference
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
PlayerID integer 32 No No Yes The player's unique PlayerID as assigned by SportsDataIO.
FirstName string 50 Yes No Yes The player's first name.
LastName string 50 Yes No Yes The player's last name.
TeamID integer 32 Yes No Yes The TeamID of the team this player is employed by.
Team string 10 Yes No Yes The key/abbreviation of the team this player is employed by.
Jersey integer 32 Yes No Yes The player's jersey number.
Position string 10 Yes No Yes The player's eligible position(s). Possible values: C, F, F-C, G, G-F
Class string 50 Yes No Yes The class of the year (e.g. Freshman, Sophomore, Junior, or Senior)
Height integer 32 Yes No Yes The player's height in inches.
Weight integer 32 Yes No Yes The player's weight in pounds (lbs).
This table is used in the following endpoints:
FantasyData CBB Fantasy API
Current Season
FantasyData CBB Odds API
Current Season
Name Type Size Nullable Scrambled CSV Description
Season integer 32 No No Yes The college basketball season of the game
StartYear integer 32 No No Yes The year in which the season started
EndYear integer 32 No No Yes The year in which the season ended
Description string 10 Yes No Yes The description of this season for display purposes (e.g. 2017-18, 2018-19, etc)
RegularSeasonStartDate date Yes No Yes The start date of the regular season
PostSeasonStartDate date Yes No Yes The start date of the postseason
ApiSeason string 50 Yes No Yes The string to pass into subsequent API calls in the season parameter
This table is used in the following endpoints:
FantasyData CBB Fantasy API
Teams, League Hierarchy
FantasyData CBB Odds API
Teams, League Hierarchy
Name Type Size Nullable Scrambled CSV Description
StadiumID integer 32 No No Yes The unique ID of the stadium
Active boolean No No Yes Whether or not this stadium is the home venue for an active team
Name string 50 No No Yes The full name of the stadium
Address string 50 Yes No Yes The address where the stadium is located
City string 50 Yes No Yes The city where the stadium is located
State string 50 Yes No Yes The US state where the stadium is located (if Stadium is outside US, this value is NULL)
Zip string 10 Yes No Yes The zip code of the stadium
Country string 10 Yes No Yes The 2-digit country code where the stadium is located
Capacity integer 32 Yes No Yes The estimated seating capacity of the stadium
GeoLat decimal 32 Yes No Yes The geographic latitude coordinate of this venue.
GeoLong decimal 32 Yes No Yes The geographic longitude coordinate of this venue.
This table is used in the following endpoints:
FantasyData CBB Fantasy API
Teams, League Hierarchy
FantasyData CBB Odds API
Teams, League Hierarchy
Name Type Size Nullable Scrambled CSV Description
TeamID integer 32 No No Yes The auto-generated unique ID of the Team
[Key] string 10 No No Yes A unique abbreviation of the team (e.g. OU, TTU, USC, UK, etc.) Due to being selected for uniqueness, these are not always a match with broadcaster abbreviations. For that use case, use ShortDisplayName.
Active boolean No No Yes Whether or not this team is active
School string 50 Yes No Yes The name of the school as used in college sports (e.g. SMU, South Florida, Stony Brook, UCLA, etc.)
Name string 50 Yes No Yes The mascot of the team (e.g. Sooners, Red Raiders, Trojans, Wildcats, etc.)
ApRank integer 32 Yes No Yes The AP Rank of the team 
Wins integer 32 Yes No Yes The total number of wins by the school
Losses integer 32 Yes No Yes The total number of losses by the school
ConferenceWins integer 32 Yes No Yes The total number of conference wins by the school
ConferenceLosses integer 32 Yes No Yes The total number of conference losses by the school
GlobalTeamID integer 32 No No No A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues.
Conference string 50 Yes No Yes The name of the team's conference
TeamLogoUrl string 100 Yes No Yes The url of the team logo image.
ShortDisplayName string 10 Yes No Yes The short display name of the team
Stadium Stadium Yes No Yes The home stadium of the team

Fantasy

This table is used in the following endpoints:
FantasyData CBB Fantasy API
Player Game Stats by Date
Name Type Size Nullable Scrambled CSV Description
StatID integer 32 No No Yes The unique ID of the stat
TeamID integer 32 Yes No Yes The unique ID of the team
PlayerID integer 32 Yes No Yes Unique ID assigned to each player that stays with them throughout their career
SeasonType integer 32 Yes No Yes The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar).
Season integer 32 Yes No Yes The college basketball season of the game
Name string 50 Yes No Yes Player's name
Team string 10 Yes No Yes The abbreviation of the Team
Position string 10 Yes No Yes The player's position associated with the given game or season. Possible values: C, F, FC, G, GF, PF, PG, SF, SG
InjuryStatus
from 2016 		string 50 Yes No Yes Indicates the player's injury status. Free text, can vary.
GameID integer 32 Yes No Yes The unique ID of this game
OpponentID integer 32 Yes No Yes The unique ID of the team's opponent
Opponent string 10 Yes No Yes The name of the opponent 
Day date Yes No Yes The day of the game
DateTime datetime Yes No Yes The date and time of the game
HomeOrAway string 4 Yes No Yes Whether the team is home or away
Games integer 32 Yes No Yes The number of games played.
FantasyPoints decimal 32 Yes Yes Yes Total fantasy points
Minutes integer 32 Yes Yes Yes Total number of minutes played
FieldGoalsMade integer 32 Yes Yes Yes Total number of field goals made
FieldGoalsAttempted integer 32 Yes Yes Yes Total number of field goals attempted
FieldGoalsPercentage decimal 32 Yes Yes Yes Total field goal percentage
TwoPointersMade integer 32 Yes Yes Yes Total two pointers made
TwoPointersAttempted integer 32 Yes Yes Yes Total two pointers attempted
TwoPointersPercentage decimal 32 Yes Yes Yes Total two pointers percentage
ThreePointersMade integer 32 Yes Yes Yes Total three pointers made
ThreePointersAttempted integer 32 Yes Yes Yes Total three pointers attempted
ThreePointersPercentage decimal 32 Yes Yes Yes Total three pointers percentage
FreeThrowsMade integer 32 Yes Yes Yes Total free throws made
FreeThrowsAttempted integer 32 Yes Yes Yes Total free throws attempted
FreeThrowsPercentage decimal 32 Yes Yes Yes Total free throws percentage
OffensiveRebounds integer 32 Yes Yes Yes Total offensive rebounds
DefensiveRebounds integer 32 Yes Yes Yes Total defensive rebounds
Rebounds integer 32 Yes Yes Yes Total rebounds
Assists integer 32 Yes Yes Yes Total assists
Steals integer 32 Yes Yes Yes Total steals
BlockedShots integer 32 Yes Yes Yes Total blocked shots
Turnovers integer 32 Yes Yes Yes Total turnovers
PersonalFouls integer 32 Yes Yes Yes Total personal fouls
Points integer 32 Yes Yes Yes Total points
FantasyPointsFanDuel decimal 32 Yes Yes Yes Total Fan Duel daily fantasy points scored
FantasyPointsDraftKings decimal 32 Yes Yes Yes Total Draft Kings daily fantasy points scored
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
StatID integer 32 No No Yes The unique ID of the stat
TeamID integer 32 Yes No Yes The unique ID of the player's team
PlayerID integer 32 Yes No Yes Unique ID assigned to each player that stays with them throughout their career
SeasonType integer 32 Yes No Yes The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar).
Season integer 32 Yes No Yes The college basketball regular season for which these totals apply
Name string 50 Yes No Yes Player's name
Team string 10 Yes No Yes The abbreviation of the Team
Position string 10 Yes No Yes Player's position in the starting lineup (if started), otherwise the position he substituted for
Games integer 32 Yes No Yes The number of games played.
FantasyPoints decimal 32 Yes Yes Yes Total fantasy points
Minutes integer 32 Yes Yes Yes Total number of minutes played
FieldGoalsMade integer 32 Yes Yes Yes Total number of field goals made
FieldGoalsAttempted integer 32 Yes Yes Yes Total number of field goals attempted
FieldGoalsPercentage decimal 32 Yes Yes Yes Total field goal percentage
TwoPointersMade integer 32 Yes Yes Yes Total two pointers made
TwoPointersAttempted integer 32 Yes Yes Yes Total two pointers attempted
TwoPointersPercentage decimal 32 Yes Yes Yes Total two pointers percentage
ThreePointersMade integer 32 Yes Yes Yes Total three pointers made
ThreePointersAttempted integer 32 Yes Yes Yes Total three pointers attempted
ThreePointersPercentage decimal 32 Yes Yes Yes Total three pointers percentage
FreeThrowsMade integer 32 Yes Yes Yes Total free throws made
FreeThrowsAttempted integer 32 Yes Yes Yes Total free throws attempted
FreeThrowsPercentage decimal 32 Yes Yes Yes Total free throws percentage
OffensiveRebounds integer 32 Yes Yes Yes Total offensive rebounds
DefensiveRebounds integer 32 Yes Yes Yes Total defensive rebounds
Rebounds integer 32 Yes Yes Yes Total rebounds
Assists integer 32 Yes Yes Yes Total assists
Steals integer 32 Yes Yes Yes Total steals
BlockedShots integer 32 Yes Yes Yes Total blocked shots
Turnovers integer 32 Yes Yes Yes Total turnovers
PersonalFouls integer 32 Yes Yes Yes Total personal fouls
Points integer 32 Yes Yes Yes Total points
FantasyPointsFanDuel decimal 32 Yes Yes Yes Total Fan Duel daily fantasy points scored
FantasyPointsDraftKings decimal 32 Yes Yes Yes Total Draft Kings daily fantasy points scored

Odds

This table is used in the following endpoints:
FantasyData CBB Odds API
Games by Date, Schedules
Name Type Size Nullable Scrambled CSV Description
GameID integer 32 No No Yes The unique ID of this game
Season integer 32 No No Yes The College Basketball season of the game
SeasonType integer 32 No No Yes The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar).
Status string 20 Yes No Yes Indicates the game's status. Possible values include: Scheduled, InProgress, Final, F/OT, Suspended, Postponed, Delayed, Canceled, Forfeit
Day date Yes No Yes The date of the game
DateTime datetime Yes No Yes The date and time of the game
AwayTeam string 10 Yes No Yes The abbreviation of the Away Team
HomeTeam string 10 Yes No Yes The abbreviation of the Home Team
AwayTeamID integer 32 Yes No Yes The unique ID of the away team
HomeTeamID integer 32 Yes No Yes The unique ID of the home team
AwayTeamScore integer 32 Yes Yes Yes Total number of points the away team scored in this game
HomeTeamScore integer 32 Yes Yes Yes Total number of points the home team scored in this game
PointSpread
from 2016 		decimal 32 Yes Yes Yes The oddsmaker Point Spread at game start from the perspective of the HomeTeam (negative numbers indicate the HomeTeam is favored, positive numbers indicate the AwayTeam is favored). This is updated once daily at 4:00 AM ET.
OverUnder
from 2016 		decimal 32 Yes Yes Yes The oddsmaker Over/Under at game start. This is updated once daily at 4:00 AM ET.
AwayTeamMoneyLine
from 2016 		integer 32 Yes Yes Yes Money line from the perspective of the away team. This is updated once daily at 4:00 AM ET.
HomeTeamMoneyLine
from 2016 		integer 32 Yes Yes Yes Money line from the perspective of the home team. This is updated once daily at 4:00 AM ET.
Periods
from 2016 		Period[] Yes No Yes The details of the periods (halves & overtime) for this game.
Stadium
from 2016 		Stadium Yes No No The stadium details of where this game was played
HomeRotationNumber integer 32 Yes Yes Yes Rotation number of home team for this game
AwayRotationNumber integer 32 Yes Yes Yes Rotation number of away team for this game
TopTeamPreviousGameId
from 2019 		integer 32 Yes Yes Yes Previous game id of the team in the top slot of an NCAA tournament game. Used for rendering.
BottomTeamPreviousGameId
from 2019 		integer 32 Yes Yes Yes Previous game id of the team in the bottom slot of an NCAA tournament game. Used for rendering.
NeutralVenue
from 2020 		boolean Yes No Yes Indicates whether this game is played in a neutral venue
AwayPointSpreadPayout
from 2021 		integer 32 Yes Yes Yes The point spread payout for the away team
HomePointSpreadPayout
from 2021 		integer 32 Yes Yes Yes The point spread payout for the home team
OverPayout
from 2021 		integer 32 Yes Yes Yes The payout when betting the Over of the Over/Under
UnderPayout
from 2021 		integer 32 Yes Yes Yes The payout when betting the Under of the Over/Under
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
GameId integer 32 No No Yes The unique ID of the game.
Season integer 32 No No Yes The calendar year of the season during which this game occurs.
SeasonType integer 32 No No Yes The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar).
Day date Yes No Yes The day that the game is scheduled to be played in UTC.
DateTime datetime Yes No Yes The date/time that the game is scheduled to be played in UTC.
Status string 20 Yes No Yes Indicates the game's status. Possible values include: Scheduled, InProgress, Final, F/OT, Suspended, Postponed, Delayed, Canceled, Forfeit
AwayTeamId integer 32 Yes No Yes The TeamId of the away team.
HomeTeamId integer 32 Yes No Yes The TeamId of the home team.
AwayTeamName string 50 Yes No Yes The name of the away team.
HomeTeamName string 50 Yes No Yes The name of the home team.
PregameOdds GameOdd[] Yes No Yes List of Pregame GameOdds from different sportsbooks
HomeTeamScore integer Yes Yes Yes Score of the home team (updated after game ends to allow for resolving bets)
AwayTeamScore integer Yes Yes Yes Score of the away team (updated after game ends to allow for resolving bets)
TotalScore integer Yes Yes Yes Total scored points in the game (updated after game ends to allow for resolving bets)
HomeRotationNumber integer 32 Yes Yes Yes Rotation number of home team for this game
AwayRotationNumber integer 32 Yes Yes Yes Rotation number of away team for this game
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
GameOddId integer 32 No No Yes Unique ID of this odd
Sportsbook string 25 No Yes Yes Name of sportsbook
GameId integer 32 No No Yes The unique ID of the game
Created datetime No No Yes The timestamp of when these odds were first created, based on US Eatern Time (EST/EDT).
Updated datetime No No Yes The timestamp of when these odds were last updated, based on US Eatern Time (EST/EDT). If these are the latest odds for this game, and they have not been updated within the last few minutes, then it indicates that there were problems connecting to the sportsbook.
HomeMoneyLine integer 32 Yes Yes Yes The sportsbook's money line for the home team
AwayMoneyLine integer 32 Yes Yes Yes The sportsbook's money line for the away team
HomePointSpread decimal 32 Yes Yes Yes The sportsbook's point spread for the home team
AwayPointSpread decimal 32 Yes Yes Yes The sportsbook's point spread for the away team
HomePointSpreadPayout integer 32 Yes Yes Yes The sportsbook's point spread payout for the home team
AwayPointSpreadPayout integer 32 Yes Yes Yes The sportsbook's point spread payout for the away team
OverUnder decimal 32 Yes Yes Yes The sportsbook's total points scored over under for the game
OverPayout integer 32 Yes Yes Yes The sportsbook's payout for the over
UnderPayout integer 32 Yes Yes Yes The sportsbook's payout for the under
SportsbookId integer 32 Yes No Yes Unique ID of the sportsbook
OddType string 50 Yes No Yes The odd type of this specific odd
This table is used in the following endpoints:
FantasyData CBB Odds API
Games by Date, Schedules
Name Type Size Nullable Scrambled CSV Description
PeriodID integer 32 No No Yes The unique ID for the period
GameID integer 32 No No Yes The unique ID of the game
Number integer 32 No No Yes The Number (Order) of the Period in the scope of the Game.
Name string 10 No No Yes The Name of the Quarter (possible values: 1, 2, OT, OT2, OT3, etc)
Type string 10 No No Yes Indicates whether this period is the first/second half or overtime (possible values: Half, Overtime)
AwayScore integer 32 Yes Yes Yes The total points scored by the away team in this Period.
HomeScore integer 32 Yes Yes Yes The total points scored by the away team in this Period.
This table is used in the following endpoints:
Name Type Size Nullable Scrambled CSV Description
StadiumID integer 32 No No Yes The unique ID of the stadium
Active boolean No No Yes Whether or not this stadium is the home venue for an active team
Name string 50 No No Yes The full name of the stadium
Address string 50 Yes No Yes The address where the stadium is located
City string 50 Yes No Yes The city where the stadium is located
State string 50 Yes No Yes The US state where the stadium is located (if Stadium is outside US, this value is NULL)
Zip string 10 Yes No Yes The zip code of the stadium
Country string 10 Yes No Yes The 2-digit country code where the stadium is located
Capacity integer 32 Yes No Yes The estimated seating capacity of the stadium
GeoLat decimal 32 Yes No Yes The geographic latitude coordinate of this venue.
GeoLong decimal 32 Yes No Yes The geographic longitude coordinate of this venue.
This table is used in the following endpoints:
FantasyData CBB Odds API
Team Game Stats by Date
Name Type Size Nullable Scrambled CSV Description
StatID integer 32 No No Yes The unique ID of the stat
TeamID integer 32 Yes No Yes The unique ID of the team
SeasonType integer 32 Yes No Yes The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar).
Season integer 32 Yes No Yes The college basketball season of the game
Name string 50 Yes No Yes Team's name
Team string 10 Yes No Yes The abbreviation of the Team
Wins integer 32 Yes No Yes Total number of team wins
Losses integer 32 Yes No Yes Total number of team losses
GameID integer 32 Yes No Yes The unique ID of this game
OpponentID integer 32 Yes No Yes The unique ID of the team's opponent
Opponent string 10 Yes No Yes The name of the opponent 
Day date Yes No Yes The day of the game
DateTime datetime Yes No Yes The date and time of the game
HomeOrAway string 4 Yes No Yes Whether the team is home or away
Games integer 32 Yes No Yes The number of games played.
FantasyPoints decimal 32 Yes Yes Yes Total fantasy points
Minutes integer 32 Yes Yes Yes Total number of minutes played
FieldGoalsMade integer 32 Yes Yes Yes Total number of field goals made
FieldGoalsAttempted integer 32 Yes Yes Yes Total number of field goals attempted
FieldGoalsPercentage decimal 32 Yes Yes Yes Total field goal percentage
TwoPointersMade integer 32 Yes Yes Yes Total two pointers made
TwoPointersAttempted integer 32 Yes Yes Yes Total two pointers attempted
TwoPointersPercentage decimal 32 Yes Yes Yes Total two pointers percentage
ThreePointersMade integer 32 Yes Yes Yes Total three pointers made
ThreePointersAttempted integer 32 Yes Yes Yes Total three pointers attempted
ThreePointersPercentage decimal 32 Yes Yes Yes Total three pointers percentage
FreeThrowsMade integer 32 Yes Yes Yes Total free throws made
FreeThrowsAttempted integer 32 Yes Yes Yes Total free throws attempted
FreeThrowsPercentage decimal 32 Yes Yes Yes Total free throws percentage
OffensiveRebounds integer 32 Yes Yes Yes Total offensive rebounds
DefensiveRebounds integer 32 Yes Yes Yes Total defensive rebounds
Rebounds integer 32 Yes Yes Yes Total rebounds
Assists integer 32 Yes Yes Yes Total assists
Steals integer 32 Yes Yes Yes Total steals
BlockedShots integer 32 Yes Yes Yes Total blocked shots
Turnovers integer 32 Yes Yes Yes Total turnovers
PersonalFouls integer 32 Yes Yes Yes Total personal fouls
Points integer 32 Yes Yes Yes Total points
FantasyPointsFanDuel decimal 32 Yes Yes Yes Total Fan Duel daily fantasy points scored
FantasyPointsDraftKings decimal 32 Yes Yes Yes Total Draft Kings daily fantasy points scored
This table is used in the following endpoints:
FantasyData CBB Odds API
Team Season Stats
Name Type Size Nullable Scrambled CSV Description
StatID integer 32 No No Yes The unique ID of the stat
TeamID integer 32 Yes No Yes The unique ID of the team
SeasonType integer 32 Yes No Yes The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar).
Season integer 32 Yes No Yes The college basketball regular season for which these totals apply
Name string 50 Yes No Yes Team name
Team string 10 Yes No Yes The abbreviation of the Team
Wins integer 32 Yes No Yes Total number of wins
Losses integer 32 Yes No Yes Total number of losses
ConferenceWins integer 32 Yes No Yes Total number of conference wins
ConferenceLosses integer 32 Yes No Yes Total number of conference losses
Games integer 32 Yes No Yes The number of games played.
FantasyPoints decimal 32 Yes Yes Yes Total fantasy points
Minutes integer 32 Yes Yes Yes Total number of minutes played
FieldGoalsMade integer 32 Yes Yes Yes Total number of field goals made
FieldGoalsAttempted integer 32 Yes Yes Yes Total number of field goals attempted
FieldGoalsPercentage decimal 32 Yes Yes Yes Total field goal percentage
TwoPointersMade integer 32 Yes Yes Yes Total two pointers made
TwoPointersAttempted integer 32 Yes Yes Yes Total two pointers attempted
TwoPointersPercentage decimal 32 Yes Yes Yes Total two pointers percentage
ThreePointersMade integer 32 Yes Yes Yes Total three pointers made
ThreePointersAttempted integer 32 Yes Yes Yes Total three pointers attempted
ThreePointersPercentage decimal 32 Yes Yes Yes Total three pointers percentage
FreeThrowsMade integer 32 Yes Yes Yes Total free throws made
FreeThrowsAttempted integer 32 Yes Yes Yes Total free throws attempted
FreeThrowsPercentage decimal 32 Yes Yes Yes Total free throws percentage
OffensiveRebounds integer 32 Yes Yes Yes Total offensive rebounds
DefensiveRebounds integer 32 Yes Yes Yes Total defensive rebounds
Rebounds integer 32 Yes Yes Yes Total rebounds
Assists integer 32 Yes Yes Yes Total assists
Steals integer 32 Yes Yes Yes Total steals
BlockedShots integer 32 Yes Yes Yes Total blocked shots
Turnovers integer 32 Yes Yes Yes Total turnovers
PersonalFouls integer 32 Yes Yes Yes Total personal fouls
Points integer 32 Yes Yes Yes Total points
FantasyPointsFanDuel decimal 32 Yes Yes Yes Total Fan Duel daily fantasy points scored
FantasyPointsDraftKings decimal 32 Yes Yes Yes Total Draft Kings daily fantasy points scored
Fantasy sports data powered by SportsDataIO's Fantasy Sports API
Odds and sports betting data powered by SportsDataIO's Betting Odds API