--- title: "Pre-Game Odds - by Date" method: GET path: "/v3/cbb/odds/{format}/GameOddsByDate/{date}" tags: ["CBB v3 Odds"] --- # Pre-Game Odds - by Date `GET /v3/cbb/odds/{format}/GameOddsByDate/{date}` ## Request - Base URL: `https://api.sportsdata.io` - URL: `https://api.sportsdata.io/v3/cbb/odds/{format}/GameOddsByDate/{date}` - Auth: one of: - API key in header `Ocp-Apim-Subscription-Key` - API key in query parameter `key` - TypeScript: (a function with typed inputs; its response is checked against the schema) Returns the full-game core odds for games in a given date. This means moneyline, spread, and total. Only returns the most recently seen odds, not-including line movement. ## Path parameters - `format` 'JSON' | 'XML', required - `date` string, required ## Response `200` Success - GameInfo[] - `GameId` integer: The unique ID of this game - `Season` integer: The season that the game occurs in. Note: season is a single year that the majority of the season occurs in. - `SeasonType` integer: The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar). - `Day` string, nullable: The day that the game is scheduled to be played in - `DateTime` string, nullable: The date and time of the game (in US Eastern Time) - `Status` string, nullable: Indicates the game's status. Possible values include: Scheduled, InProgress, Final, F/OT, Suspended, Postponed, Delayed, Canceled, Forfeit - `AwayTeamId` integer, nullable: The unique ID of the away team - `HomeTeamId` integer, nullable: The unique ID of the home team - `AwayTeamName` string, nullable: The full name of the away team (school & mascot) (E.g. Tulane Green Wave, Memphis Tigers, Arizona State Sun Devils) - `HomeTeamName` string, nullable: The full name of the home team (school & mascot) (E.g. Tulane Green Wave, Memphis Tigers, Arizona State Sun Devils) - `GlobalGameId` integer: A globally unique ID for this game. This value is guaranteed to be unique across all sports/leagues. - `GlobalAwayTeamId` integer, nullable: A globally unique ID for the away team. This value is guaranteed to be unique across all sports/leagues. - `GlobalHomeTeamId` integer, nullable: A globally unique ID for the home team. This value is guaranteed to be unique across all sports/leagues. - `PregameOdds` GameOdd[]: List of Pregame GameOdds from different sportsbooks - `GameOddId` integer: Unique ID of this odd - `Sportsbook` string, nullable: The name of the sportsbook - `GameId` integer: The unique ID of this game - `Created` string, nullable: The timestamp of when these odds were first created (in US Eastern Time) - `Updated` string, nullable: The timestamp of when these odds were last updated; based on US Eastern Time. 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, nullable: The sportsbook's money line for the home team - `AwayMoneyLine` integer, nullable: The sportsbook's money line for the away team - `HomePointSpread` number, nullable: The sportsbook's point spread for the home team - `AwayPointSpread` number, nullable: The sportsbook's point spread for the away team - `HomePointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the home team - `AwayPointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the away team. Note: this line is a consensus. - `OverUnder` number, nullable: The total points line (over/under) as given by the sportsbook - `OverPayout` integer, nullable: The odds at which the sportsbook will pay out winning Over bets at - `UnderPayout` integer, nullable: The sportsbook's payout for the under - `SportsbookId` integer, nullable: The unique ID associated with this sportsbook - `OddType` string, nullable: The market type of the odd (ex: live; pregame; 1st-half; etc.) - `SportsbookUrl` string, nullable: The URL for sportsbook event - `Unlisted` string, nullable: The timestamp of when these odds were first made unavailable to be bet on any further - `LiveOdds` GameOdd[]: Shows a list of live odds from different sportsbooks - `GameOddId` integer: Unique ID of this odd - `Sportsbook` string, nullable: The name of the sportsbook - `GameId` integer: The unique ID of this game - `Created` string, nullable: The timestamp of when these odds were first created (in US Eastern Time) - `Updated` string, nullable: The timestamp of when these odds were last updated; based on US Eastern Time. 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, nullable: The sportsbook's money line for the home team - `AwayMoneyLine` integer, nullable: The sportsbook's money line for the away team - `HomePointSpread` number, nullable: The sportsbook's point spread for the home team - `AwayPointSpread` number, nullable: The sportsbook's point spread for the away team - `HomePointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the home team - `AwayPointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the away team. Note: this line is a consensus. - `OverUnder` number, nullable: The total points line (over/under) as given by the sportsbook - `OverPayout` integer, nullable: The odds at which the sportsbook will pay out winning Over bets at - `UnderPayout` integer, nullable: The sportsbook's payout for the under - `SportsbookId` integer, nullable: The unique ID associated with this sportsbook - `OddType` string, nullable: The market type of the odd (ex: live; pregame; 1st-half; etc.) - `SportsbookUrl` string, nullable: The URL for sportsbook event - `Unlisted` string, nullable: The timestamp of when these odds were first made unavailable to be bet on any further - `HomeTeamScore` integer, nullable: Total number of points the home team scored in this game (updated after game ends to allow for resolving bets) - `AwayTeamScore` integer, nullable: Total number of points the away team scored in the game (updated after game ends to allow for resolving bets) - `TotalScore` integer, nullable: The total amount of points scored in the game by both teams. Updated after the game ends to allow for resulting bets. - `HomeRotationNumber` integer, nullable: Rotation number of home team for this game - `AwayRotationNumber` integer, nullable: Rotation number of away team for this game - `AlternateMarketPregameOdds` GameOdd[]: A list of Alternate Market Pregame GameOdds from different sportsbooks - `GameOddId` integer: Unique ID of this odd - `Sportsbook` string, nullable: The name of the sportsbook - `GameId` integer: The unique ID of this game - `Created` string, nullable: The timestamp of when these odds were first created (in US Eastern Time) - `Updated` string, nullable: The timestamp of when these odds were last updated; based on US Eastern Time. 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, nullable: The sportsbook's money line for the home team - `AwayMoneyLine` integer, nullable: The sportsbook's money line for the away team - `HomePointSpread` number, nullable: The sportsbook's point spread for the home team - `AwayPointSpread` number, nullable: The sportsbook's point spread for the away team - `HomePointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the home team - `AwayPointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the away team. Note: this line is a consensus. - `OverUnder` number, nullable: The total points line (over/under) as given by the sportsbook - `OverPayout` integer, nullable: The odds at which the sportsbook will pay out winning Over bets at - `UnderPayout` integer, nullable: The sportsbook's payout for the under - `SportsbookId` integer, nullable: The unique ID associated with this sportsbook - `OddType` string, nullable: The market type of the odd (ex: live; pregame; 1st-half; etc.) - `SportsbookUrl` string, nullable: The URL for sportsbook event - `Unlisted` string, nullable: The timestamp of when these odds were first made unavailable to be bet on any further ## Other responses - `401`: Unauthorized --- [API](https://skmtc.dev/sportsdata/apis/cbb-api.md) - [All operations](https://skmtc.dev/sportsdata/apis/cbb-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sportsdata/apis/cbb-api/revisions/2bf9419ae396?raw)