---
title: "Betting Trends - by Team"
method: GET
path: "/v3/nba/odds/{format}/TeamTrends/{team}"
tags: ["NBA v3 Odds"]
---

# Betting Trends - by Team

`GET /v3/nba/odds/{format}/TeamTrends/{team}`

## Request

- Base URL: `https://api.sportsdata.io`
- URL: `https://api.sportsdata.io/v3/nba/odds/{format}/TeamTrends/{team}`
- Auth: one of:
  - API key in header `Ocp-Apim-Subscription-Key`
  - API key in query parameter `key`
- TypeScript: <https://skmtc.dev/sportsdata/apis/nba-api/docs/v3/nba/odds/:format/TeamTrends/:team/get.ts> (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 NBA season of the game
    - `SeasonType` integer: The type of season that this record corresponds to (1=Regular Season; 2=Preseason; 3=Postseason; 4=Offseason; 5=AllStar; 6=Exhibition)
    - `Status` string, nullable: Indicates the game's status. Possible values include: Scheduled, InProgress, Final, F/OT, Suspended, Postponed, Delayed, Canceled, Forfeit, NotNecessary
    - `Day` string, nullable: The date of the game
    - `DateTime` string, nullable: The date and time of the game
    - `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 in attendance at the game
    - `AwayTeamScore` integer, nullable: Total number of points the away team scored in the game
    - `HomeTeamScore` integer, nullable: Total number of points the home team scored in this game
    - `Updated` string, nullable: The timestamp of when this game was last updated (in US Eastern Time)
    - `Quarter` string, nullable: The current quarter in the game. Possible values include: 1, 2, 3, 4, Half, OT, NULL
    - `TimeRemainingMinutes` integer, nullable: The number of minutes remaining in the quarter
    - `TimeRemainingSeconds` integer, nullable: The number of seconds remaining in the quarter
    - `PointSpread` number, nullable: The oddsmaker Point Spread 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 points scored over under for the game
    - `AwayTeamMoneyLine` integer, nullable: Money line from the perspective of the away team
    - `HomeTeamMoneyLine` integer, nullable: Money line from the perspective of the home team
    - `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 money line payout odds when betting on the away team with the point spread.
    - `PointSpreadHomeTeamMoneyLine` integer, nullable: The money line payout odds when betting on the away team with the point spread.
    - `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.
    - `IsClosed` boolean: 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
    - `Quarters` Quarter[]: The details of the quarters (including overtime periods) for this game.
      - `QuarterID` integer: Unique identifier for each Quarter.
      - `GameID` integer: The unique ID of the game associated with this quarter
      - `Number` integer: The Number (Order) of the Quarter in the scope of the Game.
      - `Name` string, nullable: The Name of the Quarter (possible values: 1, 2, 3, 4, OT, OT2, OT3, etc)
      - `AwayScore` integer, nullable: The total points scored by the away team in the given period only
      - `HomeScore` integer, nullable: The total points scored by the home team in the given period only
    - `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 this game
    - `NeutralVenue` boolean, nullable: Indicates whether this game is played in a neutral venue
    - `OverPayout` integer, nullable: The sportsbook's payout for the over on the total points line
    - `UnderPayout` integer, nullable: The sportsbook's payout for the under on the total points line
    - `CrewChiefID` integer, nullable: Unique ID of officiating Crew Chief
    - `UmpireID` integer, nullable: Unique ID of officiating Umpire referee
    - `RefereeID` integer, nullable: Unique ID of officiating referee
    - `AlternateID` integer, nullable: Unique ID of officiating Alternate referee
    - `DateTimeUTC` string, nullable: The date and time of the game in UTC
    - `SeriesInfo` Series
      - `HomeTeamWins` integer: Total number of wins by the home team in the series
      - `AwayTeamWins` integer: Total wins in the series by the away team
      - `GameNumber` integer: The game number in the series
      - `MaxLength` integer: The maximum number of games that can be played in a series
    - `InseasonTournament` boolean, nullable: A flag to indicate this game is part of the inseason NBA tournament (can be considered a part of regular season still) - a null would also indicate false
    - `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.
    - `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 TeamID of the opponent team
    - `Opponent` string, nullable: Abbreviation [Key] of the opponent team (e.g. LAL; PHI; BOS; CHI; etc.)
    - `Wins` integer: The total number of wins by the team relating to the scope. Examples of scopes include: Last 3 Games, Last 5 Home Games, Last 10 Games as Favorite, etc.
    - `Losses` integer: The total number of 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: The total number of 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: How many games the given team has covered the spread in relating to the scope of the search. Examples of scopes include: Last 3 Games, Last 5 Home Games, Last 10 Games as Favorite, etc.
    - `LossesAgainstTheSpread` integer, nullable: The total number of losses against the point spread 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 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
    - `Unders` integer, nullable: Amount of times the total score goes under the total points line
    - `OverUnderPushes` integer, nullable: Amount of times the total score pushes the total points line
    - `AverageScore` number, nullable: The average points per game scored by the given team over a certain scope (Last 3 Games, Last 5 Games, Last 10 Games, etc.)
    - `AverageOpponentScore` number, nullable: The average points per game scored by the opposing teams of a given team over a certain scope (Last 3 Games, Last 5 Games, Last 10 Games, etc.)

## Other responses

- `401`: Unauthorized

## Changes

- **2026-11-07** `30672152476c`: 1 info
  - added the optional property `UpcomingGame/Deleted` to the response with the `200` status

[Operation history](https://skmtc.dev/sportsdata/apis/nba-api/changes/v3/nba/odds/:format/TeamTrends/:team/get.md)

---

[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)
