--- title: "Betting Trends - by Team" method: GET path: "/v3/nfl/odds/{format}/TeamTrends/{team}" tags: ["NFL v3 Odds"] --- # Betting Trends - by Team `GET /v3/nfl/odds/{format}/TeamTrends/{team}` ## Request - Base URL: `https://api.sportsdata.io` - URL: `https://api.sportsdata.io/v3/nfl/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` Score - `GameKey` string, nullable: A 9 digit unique code identifying the game that this record corresponds to. The GameID is composed of Season; SeasonType; Week and HomeTeam. Note: This value will be NULL for bye weeks - `SeasonType` integer: The type of season that this game corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=All-Star). - `Season` integer: The NFL season of the game - `Week` integer: The NFL week of the game (regular season: 1 to 18; preseason: 0 to 4; postseason: 1 to 4). Note: seasons after 2021 will have only 3 preseason weeks - `Date` string, nullable: The date and time of the game (in US Eastern Time) - `AwayTeam` string, nullable: The abbreviation [Key} of the away team - `HomeTeam` string, nullable: The abbreviation [Key] of the home team - `AwayScore` integer, nullable: The final score of the Away Team - `HomeScore` integer, nullable: The final score of the Home Team - `Channel` string, nullable: The television station broadcasting the game - `PointSpread` number, nullable: The oddsmaker point spread at game start from the perspective of the team (negative numbers indicate the HomeTeam is favored; positive numbers indicate the AwayTeam is favored) - `OverUnder` number, nullable: The total points line (over/under) at game start - `Quarter` string, nullable: The current quarter of the game (1, 2, 3, 4, HALF, OT, F, F/OT or NULL if game has not yet started) - `TimeRemaining` string, nullable: The amount of time remaining in the current quarter (e.g. 11:23; 5:34; NULL if game is not in progress or at halftime) - `Possession` string, nullable: The team that currently has possession of the ball (Ex. PHI; NE; NULL if game is not in progress or at halftime) - `Down` integer, nullable: The current down in the game (1, 2, 3, 4 or NULL) - `Distance` string, nullable: The yards to go for a first down (this can be any positive number or "Goal") - `YardLine` integer, nullable: the yard line of the ball's current position on the field as of the most recently completed play - `YardLineTerritory` string, nullable: The team's side of the field that the ball is on when the play occurred - `RedZone` string, nullable: The team abbreviation [Key] that currently has the ball in the opponent's red zone (Ex: "SF"; "BAL" or NULL) - `AwayScoreQuarter1` integer, nullable: Points scored by the away team in Quarter 1 - `AwayScoreQuarter2` integer, nullable: Points scored by the away team in Quarter 2 - `AwayScoreQuarter3` integer, nullable: Points scored by the away team in Quarter 3 - `AwayScoreQuarter4` integer, nullable: Points scored by the away team in Quarter 4 - `AwayScoreOvertime` integer, nullable: Points scored by the away team in overtime - `HomeScoreQuarter1` integer, nullable: Points scored by the home team in Quarter 1 - `HomeScoreQuarter2` integer, nullable: Points scored by the home team in Quarter 2 - `HomeScoreQuarter3` integer, nullable: Points scored by the home team in Quarter 3 - `HomeScoreQuarter4` integer, nullable: Points scored by the home team in Quarter 4 - `HomeScoreOvertime` integer, nullable: Points scored by the home team in overtime - `HasStarted` boolean: Whether the game has started (true/false) - `IsInProgress` boolean: Whether the game is currently in progress (true/false) - `IsOver` boolean: Whether the game is over (true/false) - `Has1stQuarterStarted` boolean: Whether the 1st quarter has started - `Has2ndQuarterStarted` boolean: Whether the 2nd quarter has started - `Has3rdQuarterStarted` boolean: Whether the 3rd quarter has started - `Has4thQuarterStarted` boolean: Whether the 4th quarter has started - `IsOvertime` boolean: Whether this game went into overtime - `DownAndDistance` string, nullable: The description of the down and distance for display purposes - `QuarterDescription` string, nullable: Description of the current quarter for display purposes - `StadiumID` integer, nullable: The unique ID of the team's current home stadium - `LastUpdated` string, nullable: The date and time that this game was last updated (in US Eastern Time) - `GeoLat` number, nullable: The geographic latitude coordinate of the venue where the game is taking place - `GeoLong` number, nullable: The geographic longitude coordinate of the venue where the game is taking place - `ForecastTempLow` integer, nullable: The forecasted low temperature on game day at this venue (Fahrenheit) - `ForecastTempHigh` integer, nullable: The forecasted high temperature on game day at this venue (Fahrenheit) - `ForecastDescription` string, nullable: The forecast description on game day at this venue. - `ForecastWindChill` integer, nullable: The forecasted wind chill on game day at this venue. - `ForecastWindSpeed` integer, nullable: The forecasted wind speed on game day at this venue. - `AwayTeamMoneyLine` integer, nullable: The sportsbook's moneyline for the away team - `HomeTeamMoneyLine` integer, nullable: The sportsbook's moneyline for the home team - `Canceled` boolean, nullable: Indicates whether the game was canceled - `Closed` 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 - `LastPlay` string, nullable: The description of the most recent play/event of the game. Note: This is for display purposes and does not include corresponding data points - `Day` string, nullable: The date of the game (in US Eastern Time) - `DateTime` string, nullable: The date and time of the game (in US Eastern Time) - `AwayTeamID` integer, nullable: The unique ID of the away team - `HomeTeamID` integer, nullable: The unique ID of the home team - `GlobalGameID` integer, nullable: 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 - `PointSpreadAwayTeamMoneyLine` integer, nullable: The payout on the away team's spread - `PointSpreadHomeTeamMoneyLine` integer, nullable: The payout on the home team's spread - `ScoreID` integer: Unique ID of the Score/Game - `StadiumDetails` Stadium - `StadiumID` integer: The unique ID of the stadium - `Name` string, nullable: The full name of the stadium - `City` string, nullable: The city where the stadium is located - `State` string, nullable: The city where the venue is located - `Country` string, nullable: The 3-digit country code where the stadium is located - `Capacity` integer, nullable: The estimated seating capacity of the stadium - `PlayingSurface` string, nullable: The playing surface of the stadium (Grass, Artificial or Dome) - `GeoLat` number, nullable: The geographic latitude coordinate of this venue - `GeoLong` number, nullable: The geographic longitude coordinate of this venue. - `Type` string, nullable: The type of the stadium (possible values: Outdoor, Dome, RetractableDome) - `Status` string, nullable: The status of the game. For a description of possible values, see here. For how suspended and postponed games are handled specifically, see here. - `GameEndDateTime` string, nullable: The date and time of when the game officially ended. Note: This field is populated after the game and score are finalized - `HomeRotationNumber` integer, nullable: Rotation number of home team in this game - `AwayRotationNumber` integer, nullable: Rotation number of away team in this game - `NeutralVenue` boolean, nullable: Indicates whether this game is played in a neutral venue - `RefereeID` integer, nullable: The unique ID of the head referee - `OverPayout` integer, nullable: The sportsbook's payout for over the total points line - `UnderPayout` integer, nullable: The sportsbook's payout for the under - `HomeTimeouts` integer, nullable: The number of timeouts remaining for the Home Team - `AwayTimeouts` integer, nullable: The number of timeouts remaining for the Away Team - `DateTimeUTC` string, nullable: The date and time of the game (in UTC) - `Attendance` integer: The total attendance for the game - `IsClosed` boolean, nullable: Indicates whether the game is over and the final score has been verified and closed out. - `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 opponent team - `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: Losses relating to the scope. Examples of scopes include: Last 3 Games, Last 5 Home Games, Last 10 Games as Favorite, etc. - `Ties` integer: Total ties by the team 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: Losses against the spread 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 spread 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 points line (over/under) - `Unders` integer, nullable: Amount of times the total score goes under the total points line (over/under) - `OverUnderPushes` integer, nullable: Amount of times the total score pushes the total point line (over/under) - `AverageScore` number, nullable: Average score of team - `AverageOpponentScore` number, nullable: Average score of opponent ## Other responses - `401`: Unauthorized ## Changes - **2026-11-07** `2dca8b6e9675`: 1 info - added the optional property `UpcomingGame/Deleted` to the response with the `200` status [Operation history](https://skmtc.dev/sportsdata/apis/nfl-api/changes/v3/nfl/odds/:format/TeamTrends/:team/get.md) --- [API](https://skmtc.dev/sportsdata/apis/nfl-api.md) - [All operations](https://skmtc.dev/sportsdata/apis/nfl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sportsdata/apis/nfl-api/revisions/2dca8b6e9675?raw)