--- title: "Betting Events - by Date" method: GET path: "/v3/nba/odds/{format}/BettingEventsByDate/{date}" tags: ["NBA v3 Odds"] --- # Betting Events - by Date `GET /v3/nba/odds/{format}/BettingEventsByDate/{date}` ## Request - Base URL: `https://api.sportsdata.io` - URL: `https://api.sportsdata.io/v3/nba/odds/{format}/BettingEventsByDate/{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) The list of current BettingEvents for the given date. Events in this include market information but no outcomes will be included here. Intended to allow both visibility to Events in order to match up Events -> Games via the included GameID (where applicable) as well as provide a list of MarketIDs which are included in the given event. ## Path parameters - `format` 'JSON' | 'XML', required - `date` string, required ## Response `200` Success - BettingEvent[] - `BettingEventID` integer: The unique ID associated with the betting event - `Name` string, nullable: The name of this betting event - `Season` integer, nullable: The NBA season of the BettingEvent - `BettingEventTypeID` integer: The ID associated with the type of betting event - `BettingEventType` string, nullable: Indicates the type of betting event - Game or Future - `StartDate` string, nullable: The furthest forward time any sportsbook has an event or market set to start for this betting event - `Created` string, nullable: The date and time when this betting event was created (in US Eastern Time) - `Updated` string, nullable: The timestamp of the last time this betting event was updated (in US Eastern Time) - `GameID` integer, nullable: The unique ID of the game associated with this BettingEvent - `GlobalGameID` integer, nullable: The GlobalGameID of the game tied to this event - `GameStatus` string, nullable: The status of the game in tied to this event - `Quarter` string, nullable: The current quarter in the game tied to this betting event. Possible values include: 1; 2; 3; 4; Half; OT; NULL - `AwayTeam` string, nullable: The abbreviation [Key] of the away team tied to the event - `HomeTeam` string, nullable: The abbreviation [Key] of the home team - `AwayTeamID` integer, nullable: The unique ID of the away team tied to the event - `HomeTeamID` integer, nullable: The unique ID of the home team tied to the event - `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 - `AwayTeamScore` integer, nullable: Total number of points the away team scored in the game tied to the event (post-game) - `HomeTeamScore` integer, nullable: Total points scored by the home team in the game (post-game) - `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 - `AwayRotationNumber` integer, nullable: Rotation number of away team for this event Note: if the betting event is a future this field will be NULL - `HomeRotationNumber` integer, nullable: The rotation number of the home team for this event Note: If betting event is a future this field will be NULL - `BettingMarkets` BettingMarket[]: The list of betting markets for this event - `BettingMarketID` integer: The unique ID associated with the betting market - `BettingEventID` integer: The unique ID associated with the betting event - `BettingMarketTypeID` integer, nullable: Unique ID that distinguishes the different types of Market Types - `BettingMarketType` string, nullable: The name of the market type within a market (e.g. Player Prop, Team Prop, Game Prop, etc.) - `BettingBetTypeID` integer, nullable: The ID associated with the name of the bet type within a market - `BettingBetType` string, nullable: The name of the bet type within a market (e.g. Total Points, Moneyline, Spread, etc.) - `BettingPeriodTypeID` integer, nullable: The BettingPeriodTypeID of this type of market which we can result - `BettingPeriodType` string, nullable: The name of the period type of this market (e.g. Full Game; 1st Half; 2nd Quarter; Regular Season) - `Name` string, nullable: The generic name of this market - `TeamID` integer, nullable: The unique ID of the team tied to this market (if applicable) - `TeamKey` string, nullable: The abbreviation [Key] of the team associated with this market (if applicable) - `PlayerID` integer, nullable: The player's unique PlayerID as assigned by SportsDataIO. Note: this ID will stay with the player throughout their entire career - `PlayerName` string, nullable: The name of the player tied to this market (if applicable) - `Created` string, nullable: The date and time when this betting market was created (in US Eastern Time) - `Updated` string, nullable: The timestamp of the last time this betting market was updated (in US Eastern Time) - `AvailableSportsbooks` Sportsbook[]: A list of sportsbooks that have odds available in a given market - `SportsbookID` integer: The unique identifier of the sportsbook - `Name` string, nullable: The name of the sportsbooks - `AnyBetsAvailable` boolean, nullable: A field that returns "True" if there are any available bets to make within the market in question. If there are no bets available to make, the field returns "False" - `BettingOutcomes` BettingOutcome[]: The list of betting outcomes from each sportsbook in this market - `BettingOutcomeID` integer, nullable: The unique ID associated with this specific outcome - `BettingMarketID` integer, nullable: The unique ID associated with the betting market - `SportsBook` Sportsbook - `SportsbookID` integer: The unique identifier of the sportsbook - `Name` string, nullable: The name of the sportsbooks - `BettingOutcomeTypeID` integer, nullable: The BettingOutcomeTypeID of this outcome - `BettingOutcomeType` string, nullable: The name of outcome type (e.g. Home; Away; Under; Over) - `PayoutAmerican` integer, nullable: The american odds payout - `PayoutDecimal` number, nullable: The decimal odds payout - `Value` number, nullable: The number associated with the outcome of a market (e.g. the spread, game total, etc.) - `Participant` string, nullable: The name of the participant (typically team or player) associated with the outcome. NOTE: this is provided by the sportsbook. In the case of Player odds, we highly recommend using PlayerID as names of players can be inconsistent between sportsbooks. - `IsAvailable` boolean, nullable: Indicates whether a BettingOutcome is available for betting or not - `IsAlternate` boolean, nullable: Is this an alternate value or the core value - `Created` string, nullable: The date and time when this betting outcome was created (in US Eastern Time) - `Updated` string, nullable: The timestamp of the last time this betting outcome was updated (in US Eastern Time) - `Unlisted` string, nullable: The timestamp of when these odds were first made unavailable to be bet on any further (in US Eastern Time) - `TeamID` integer, nullable: The unique ID of the team tied to this outcome (if applicable) - `PlayerID` integer, nullable: The player's unique PlayerID as assigned by SportsDataIO (where applicable). Note: this ID will stay with the player throughout their entire career - `GlobalTeamID` integer, nullable: A globally unique ID for this team (where applicable). This value is guaranteed to be unique across all sports/leagues. - `SportsbookUrl` string, nullable: The URL for sportsbook event - `IsInPlay` boolean, nullable: Was this outcome created after the start time of the game (only applies when the betting event is of type game) - `SportsbookMarketID` string, nullable: The market ID on the given sportsbook for deeplinking (when available) - `SportsbookOutcomeID` string, nullable: The outcome ID on the given sportsbook for deeplinking (when available) - `ConsensusOutcomes` ConsensusOutcome[]: The single set of consensus outcomes of this market - `NumberOfSportsbooks` integer: The number of sportsbooks odds that went into creating this consensus outcome - `BettingOutcomeID` integer, nullable: The unique ID associated with this specific outcome - `BettingMarketID` integer, nullable: The unique ID associated with the betting market - `SportsBook` Sportsbook - `SportsbookID` integer: The unique identifier of the sportsbook - `Name` string, nullable: The name of the sportsbooks - `BettingOutcomeTypeID` integer, nullable: The BettingOutcomeTypeID of this outcome - `BettingOutcomeType` string, nullable: The name of outcome type (e.g. Home; Away; Under; Over) - `PayoutAmerican` integer, nullable: The american odds payout - `PayoutDecimal` number, nullable: The decimal odds payout - `Value` number, nullable: The number associated with the outcome of a market (e.g. the spread, game total, etc.) - `Participant` string, nullable: The name of the participant (typically team or player) associated with the outcome. NOTE: this is provided by the sportsbook. In the case of Player odds, we highly recommend using PlayerID as names of players can be inconsistent between sportsbooks. - `IsAvailable` boolean, nullable: Indicates whether a BettingOutcome is available for betting or not - `IsAlternate` boolean, nullable: Is this an alternate value or the core value - `Created` string, nullable: The date and time when this betting outcome was created (in US Eastern Time) - `Updated` string, nullable: The timestamp of the last time this betting outcome was updated (in US Eastern Time) - `Unlisted` string, nullable: The timestamp of when these odds were first made unavailable to be bet on any further (in US Eastern Time) - `TeamID` integer, nullable: The unique ID of the team tied to this outcome (if applicable) - `PlayerID` integer, nullable: The player's unique PlayerID as assigned by SportsDataIO (where applicable). Note: this ID will stay with the player throughout their entire career - `GlobalTeamID` integer, nullable: A globally unique ID for this team (where applicable). This value is guaranteed to be unique across all sports/leagues. - `SportsbookUrl` string, nullable: The URL for sportsbook event - `IsInPlay` boolean, nullable: Was this outcome created after the start time of the game (only applies when the betting event is of type game) - `SportsbookMarketID` string, nullable: The market ID on the given sportsbook for deeplinking (when available) - `SportsbookOutcomeID` string, nullable: The outcome ID on the given sportsbook for deeplinking (when available) - `IsArchived` boolean: Indicates whether a BettingOutcome has been archived or not - `ArchiveLocation` string, nullable: If IsArchived is true, this returns the URL that can be used to retrieve the archived BettingOutcomes. An API Key and Sportsbook Grouping will be required to retrieve this information. If IsArchived is false, this returns an empty string - `GameStartTime` string, nullable: The date and time that the game started (in US Eastern Time) ## Other responses - `401`: Unauthorized --- [API](https://skmtc.dev/sportsdata/apis/nba-api.md) - [All operations](https://skmtc.dev/sportsdata/apis/nba-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sportsdata/apis/nba-api/revisions/30672152476c?raw)