--- title: "Betting Trends - by Team" method: GET path: "/v3/nhl/odds/{format}/TeamTrends/{team}" tags: ["NHL v3 Odds"] --- # Betting Trends - by Team `GET /v3/nhl/odds/{format}/TeamTrends/{team}` ## Request - Base URL: `https://api.sportsdata.io` - URL: `https://api.sportsdata.io/v3/nhl/odds/{format}/TeamTrends/{team}` - 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) Describes recent team trends and performance against betting data in recent sets of games. ## Path parameters - `format` 'JSON' | 'XML', required - `team` string, required ## Response `200` Success - TeamTrends - `Team` string, nullable: The abbreviation [Key] of the team - `TeamID` integer, nullable: The unique ID of the team - `UpcomingGame` Game - `GameID` integer: The unique ID of this game - `Season` integer: The NHL season of the game - `SeasonType` integer: The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 5=AllStar, 6=Exhibition). - `Status` string, nullable: Indicates the game's status. Possible values include: Scheduled, InProgress, Final, F/SO, F/OT, Postponed, Canceled, NotNecessary - `Day` string, nullable: The date of the game - `DateTime` string, nullable: The date and time of the game in US Eastern Time - `Updated` string, nullable: The timestamp of when the record was last updated (in US Eastern Time). - `IsClosed` boolean, nullable: Indicates whether the game is over and the final score has been verified and closed out. NOTE: it is recommend for bet resulting to use IsClosed = True rather than simply Final game status - `AwayTeam` string, nullable: The abbreviation [Key] of the away team - `HomeTeam` string, nullable: The abbreviation [Key] of the home team - `AwayTeamID` integer: The unique ID of the away team - `HomeTeamID` integer: The unique ID of the home team - `StadiumID` integer, nullable: The unique ID of the stadium - `Channel` string, nullable: The television station broadcasting the game - `Attendance` integer, nullable: The total number of people who attended the game - `AwayTeamScore` integer, nullable: Total number of goals scored by the away team in the game - `HomeTeamScore` integer, nullable: Total number of goals scored by the home team in the game - `Period` string, nullable: Indicates the current period of the game. Possible values include: 1; 2; 3; OT; SO; NULL - `TimeRemainingMinutes` integer, nullable: Number of minutes remaining in the current period - `TimeRemainingSeconds` integer, nullable: Number of seconds that have passed in the current period. NOTE: this field name might be misleading as it actually represents the game clock sconds which are the number of minutes that have already passed in the period. - `AwayTeamMoneyLine` integer, nullable: Moneyline from the perspective of the away team - `HomeTeamMoneyLine` integer, nullable: Moneyline from the perspective of the home team - `PointSpread` number, nullable: The oddsmaker puck line at game start from the perspective of the HomeTeam (negative numbers indicate the HomeTeam is favored; positive numbers indicate the AwayTeam is favored). - `OverUnder` number, nullable: The sportsbook's total goals scored line (Over/Under) for the game - `GlobalGameID` integer: A globally unique ID for this game. This value is guaranteed to be unique across all sports/leagues. - `GlobalAwayTeamID` integer: A globally unique ID for the away team. This value is guaranteed to be unique across all sports/leagues. - `GlobalHomeTeamID` integer: A globally unique ID for the home team. This value is guaranteed to be unique across all sports/leagues. - `PointSpreadAwayTeamMoneyLine` integer, nullable: The payout odds when betting on the away team with the puck line - `PointSpreadHomeTeamMoneyLine` integer, nullable: The payout odds when betting on the home team with the puck line - `LastPlay` string, nullable: The description of the most recent play/event of the game. This is for display purposes and does not include corresponding data points. - `Periods` Period[]: The details of the periods (including overtime if applicable) for this game. - `PeriodID` integer: The unique ID associated of this period - `GameID` integer: The unique ID of this game tied to this period - `Name` string, nullable: The name of the period (possible values: 1; 2; 3; SO; OT; OT2; OT3; OT4; etc) - `AwayScore` integer, nullable: Total goals scored by the away team in a given period - `HomeScore` integer, nullable: Total goals scored by the home team in the period - `ScoringPlays` ScoringPlay[]: The details of the scoring plays that occurred during this period - `ScoringPlayID` integer: The unique ID of the scoring play - `PeriodID` integer: The unique ID associated of this period - `Sequence` integer, nullable: The sequence/order that this scoring play happened - `TimeRemainingMinutes` integer, nullable: Number of minutes that have passed in the current period. NOTE: this field name might be misleading as it actually represents the game clock minutes which are the number of minutes that have already passed in the period. - `TimeRemainingSeconds` integer, nullable: Number of seconds that have passed in the current period. NOTE: this field name might be misleading as it actually represents the game clock sconds which are the number of minutes that have already passed in the period. - `ScoredByTeamID` integer, nullable: The TeamID of the team that scored the goal - `AllowedByTeamID` integer, nullable: The TeamID of the team that allowed the goal - `ScoredByPlayerID` integer, nullable: The PlayerID of the player who scored the goal - `AssistedByPlayerID1` integer, nullable: The PlayerID of the FIRST player who assisted on the goal - `AssistedByPlayerID2` integer, nullable: The PlayerID of the SECOND player who assisted on the goal - `PowerPlay` boolean, nullable: Whether or not the goal was scored on the power play - `ShortHanded` boolean, nullable: Whether the goal was scored shorthanded - `EmptyNet` boolean, nullable: Whether the goal was an empty net goal or not - `AwayTeamScore` integer, nullable: The score of the away team after the conclusion of the scoring play - `HomeTeamScore` integer, nullable: The score of the home team after the conclusion of the scoring play - `Penalties` Penalty[]: The details of the penalties that occurred during this period - `PenaltyID` integer: The unique ID of this penalty - `PeriodID` integer: The unique ID of the period during which this penalty occurred - `Sequence` integer, nullable: The sequence/order that this penalty happened - `TimeRemainingMinutes` integer, nullable: Number of minutes that have passed in the current period. NOTE: this field name might be misleading as it actually represents the game clock minutes which are the number of minutes that have already passed in the period. - `TimeRemainingSeconds` integer, nullable: Number of seconds that have passed in the current period. NOTE: this field name might be misleading as it actually represents the game clock seconds which are the number of minutes that have already passed in the period. - `Description` string, nullable: The description of the penalty - `PenaltyMinutes` integer, nullable: Total minutes the penalty lasts - `PenalizedTeamID` integer, nullable: The TeamID of the team who committed the penalty - `PenalizedPlayerID` integer, nullable: The PlayerID of the player who committed the penalty - `DrawnByTeamID` integer, nullable: The TeamID of the player/team that drew the penalty - `DrawnByPlayerID` integer, nullable: The PlayerID of the player who drew the penalty - `IsBenchPenalty` boolean, nullable: Whether or not the penalty is a bench penalty - `BenchPenaltyServedByPlayerID` integer, nullable: The PlayerID of the player who served the bench penalty - `GameEndDateTime` string, nullable: The date and time that the game ended in US Eastern Time - `HomeRotationNumber` integer, nullable: The rotation number of the home team for this game - `AwayRotationNumber` integer, nullable: The rotation number of the away team for a game - `NeutralVenue` boolean, nullable: Indicates whether this game is played in a neutral venue - `OverPayout` integer, nullable: The sportsbook's payout for the over - `UnderPayout` integer, nullable: The sportsbook's payout for the under - `DateTimeUTC` string, nullable: The date and time of the game in UTC - `SeriesInfo` Series - `HomeTeamWins` integer: Total wins in the series by the home team - `AwayTeamWins` integer: Total wins in the series by the away team - `GameNumber` integer: The number of the game being played in the series - `MaxLength` integer: The maximum number of games that can be played in a postseason series - `RescheduledFromGameID` integer, nullable: The GameID of the originally scheduled, postponed game, that this game was rescheduled from. This only pertains to games that are scheduled as "make up" games. - `RescheduledGameID` integer, nullable: The GameID of the game that was rescheduled from this game. This only pertains to postponed games that require rescheduling. - `Referee1ID` integer, nullable: The unique ID of the main referee of this game - `Referee2ID` integer, nullable: The unique ID of the secondary referee of this game - `Linesperson1ID` integer, nullable: The unique ID of the main linesperson of this game - `Linesperson2ID` integer, nullable: The unique ID of the secondary linesperson of this game - `Deleted` boolean: Indicates whether the game or event has been soft deleted and never existed on the real-life schedule. Deleted records have their Status set to Canceled and are retained for reference only. - `TeamGameTrends` TeamGameTrends[]: The collection of Game Trends for this team - `Scope` string, nullable: The type of Trend (e.g. Last 5 games, Last 10 games, Last 5 home games, etc.) - `TeamID` integer: The unique ID of the team - `Team` string, nullable: The abbreviation [Key] of the team - `OpponentID` integer, nullable: The unique ID of the team's opponent - `Opponent` string, nullable: The abbreviation [Key] of the opponent team - `Wins` integer: Total number of wins relating to the scope (Examples of Scopes include: Last 3 Games; Last 5 Home Games; Last 10 Games as favorite, etc.) - `Losses` integer: Total losses by the team relating to the scope (Examples of Scopes include: Last 3 Games; Last 5 Home Games; Last 10 Games as favorite, etc.) - `Ties` integer: Ties relating to the scope (Examples of Scopes include: Last 3 Games; Last 5 Home Games; Last 10 Games as favorite, etc.) - `WinsAgainstTheSpread` integer, nullable: Total number of wins against the spread relating to the scope (Examples of Scopes include: Last 3 Games; Last 5 Home Games; Last 10 Games as favorite, etc.) - `LossesAgainstTheSpread` integer, nullable: Total losses against the puck line by the team relating to the scope (Examples of Scopes include: Last 3 Games; Last 5 Home Games; Last 10 Games as favorite, etc.) - `PushesAgainstTheSpread` integer, nullable: Pushes against the puck line relating to the scope (Examples of Scopes include: Last 3 Games; Last 5 Home Games; Last 10 Games as favorite, etc.) - `Overs` integer, nullable: Amount of times the total score goes over the total goals line - `Unders` integer, nullable: Amount of times the total score goes under the toal goals line - `OverUnderPushes` integer, nullable: Amount of times the total score pushes the total goals line - `AverageScore` number, nullable: The average goals per game scored by the team relating to the scope (Examples of Scopes include: Last 3 Games; Last 5 Home Games; Last 10 Games as favorite, etc.) - `AverageOpponentScore` number, nullable: The average goals per game scored by the opposing teams relating to the scope (Examples of Scopes include: Last 3 Games; Last 5 Home Games; Last 10 Games as favorite, etc.) ## Other responses - `401`: Unauthorized --- [API](https://skmtc.dev/sportsdata/apis/nhl-api.md) - [All operations](https://skmtc.dev/sportsdata/apis/nhl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sportsdata/apis/nhl-api/revisions/23cc22d7f2ad?raw)