--- title: "Betting Futures - by Season" method: GET path: "/v3/cbb/odds/{format}/BettingFuturesBySeason/{season}" tags: ["CBB v3 Odds"] --- # Betting Futures - by Season `GET /v3/cbb/odds/{format}/BettingFuturesBySeason/{season}` ## Request - Base URL: `https://api.sportsdata.io` - URL: `https://api.sportsdata.io/v3/cbb/odds/{format}/BettingFuturesBySeason/{season}` - 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 available Futures markets for the given season. Does not include line movement. ## Path parameters - `format` 'JSON' | 'XML', required - `season` 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 season that this betting event occurs in. Note: season is a single year that the majority of the season occurs in - `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 date and time a specified event is scheduled to begin. Note: For Futures, this will be the furthest forward time a book has a market set to close - `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 this game tied to this event - `GlobalGameID` integer, nullable: A globally unique ID for this game. This value is guaranteed to be unique across all sports/leagues - `GameStatus` string, nullable: The status of the game in tied to this event. A list of CBB game statuses can be found here - `AwayTeam` string, nullable: The abbreviation [Key] of the away team tied to the event - `HomeTeam` string, nullable: The abbreviation [Key] of the home team tied to this event - `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 this event - `GlobalAwayTeamID` integer, nullable: A globally unique ID for the away team tied to this event This value is guaranteed to be unique across all sports/leagues - `GlobalHomeTeamID` integer, nullable: A globally unique ID for the home team tied to this event. 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 number of points the home team scored in this game (post-game) - `TotalScore` integer, nullable: The total amount of points scored in the game by both teams, posted after the conclusion of the game - `AwayRotationNumber` integer, nullable: Rotation number of away team in the game tied to this event. - `HomeRotationNumber` integer, nullable: Rotation number of home team for this game for this event - `BettingMarkets` BettingMarket[]: The list of betting markets for this event - `BettingMarketID` integer: The unique identifier of this betting market - `BettingEventID` integer: The unique ID associated with the betting market - `BettingMarketTypeID` integer, nullable: The unique ID associated with this type of betting market - `BettingMarketType` string, nullable: The name of the market type (e.g. Player Prop, Team Prop, Game Prop, etc.) - `BettingBetTypeID` integer, nullable: The unique ID associated with the betting event - `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 market - `BettingPeriodType` string, nullable: The BettingPeriodType 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 (if applicable) - `TeamKey` string, nullable: The abbreviation [Key] of the team tied to this market (if applicable) - `PlayerID` integer, nullable: The player's unique PlayerID as assigned by SportsDataIO (if applicable). Note: this ID will stay with the player throughout their collegiate career - `PlayerName` string, nullable: The full name of the player associated with 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 ID associated with this sportsbook - `Name` string, nullable: The name of the sportsbook - `AnyBetsAvailable` boolean, nullable: A field that returns "Yes" if there are any available bets to make within the market in question. If there are no bets available to make, the field returns "No" - `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 ID associated with this sportsbook - `Name` string, nullable: The name of the sportsbook - `BettingOutcomeTypeID` integer, nullable: The BettingOutcomeTypeID of this outcome - `BettingOutcomeType` string, nullable: The name of betting outcome type (e.g. Home; Away; Under; Over) - `PayoutAmerican` integer, nullable: The payout of the bet, shown in American odds format - `PayoutDecimal` number, nullable: The payout of the bet, shown in Decimal odds format - `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 a team or player) associated with a given 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 - `TeamID` integer, nullable: The unique ID of the team (if applicable) - `PlayerID` integer, nullable: The player's unique PlayerID as assigned by SportsDataIO (if applicable). Note: this ID will stay with the player throughout their collegiate career - `GlobalTeamID` integer, nullable: A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues (where applicable) - `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 from the given sportsbook when available - `SportsbookOutcomeID` string, nullable: The outcome ID from the given sportsbook 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 ID associated with this sportsbook - `Name` string, nullable: The name of the sportsbook - `BettingOutcomeTypeID` integer, nullable: The BettingOutcomeTypeID of this outcome - `BettingOutcomeType` string, nullable: The name of betting outcome type (e.g. Home; Away; Under; Over) - `PayoutAmerican` integer, nullable: The payout of the bet, shown in American odds format - `PayoutDecimal` number, nullable: The payout of the bet, shown in Decimal odds format - `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 a team or player) associated with a given 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 - `TeamID` integer, nullable: The unique ID of the team (if applicable) - `PlayerID` integer, nullable: The player's unique PlayerID as assigned by SportsDataIO (if applicable). Note: this ID will stay with the player throughout their collegiate career - `GlobalTeamID` integer, nullable: A globally unique ID for this team. This value is guaranteed to be unique across all sports/leagues (where applicable) - `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 from the given sportsbook when available - `SportsbookOutcomeID` string, nullable: The outcome ID from the given sportsbook when available - `IsArchived` boolean: Indicates whether a BettingOutcome has been archived or not. If Archived, that outcome is no longer available - `ArchiveLocation` string, nullable: Indicates the URL that can be used to retrieve archived BettingOutcomes. An API Key and Sportsbook Grouping will be required to retrieve this information - `GameStartTime` string, nullable: The date and time that the game started. Note: Time is in US Eastern Time ## 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)