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

# Betting Trends - by Team

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

## Request

- Base URL: `https://api.sportsdata.io`
- URL: `https://api.sportsdata.io/v3/cfb/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/cfb-api/docs/v3/cfb/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 College Football 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).
    - `Week` integer, nullable: The week of the game
    - `Status` string, nullable: The status of the game. Possible values include: Scheduled; InProgress; Final; F/OT; Suspended; Postponed; Delayed; Canceled; Forfeit
    - `Day` string, nullable: The date of the game
    - `DateTime` 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
    - `AwayTeamID` integer: The unique ID of the away team
    - `HomeTeamID` integer: The unique ID of the home team
    - `AwayTeamName` string, nullable: The name of the away team
    - `HomeTeamName` string, nullable: The name of the home team
    - `AwayTeamScore` integer, nullable: Total number of points the away team scored in this game
    - `HomeTeamScore` integer, nullable: Total number of points the home team scored in this game
    - `Period` string, nullable: The current quarter in the game (Possible Values: 1; 2; 3; 4; Half; OT; F; F/OT; NULL)
    - `TimeRemainingMinutes` integer, nullable: Total number of minutes remaining in the quarter
    - `TimeRemainingSeconds` integer, nullable: Total number of seconds remaining in the quarter
    - `PointSpread` number, nullable: The oddsmaker Point Spread at game start from the perspective of the HomeTeam. Note: negative numbers indicate the HomeTeam is favored; positive numbers indicate the AwayTeam is favored
    - `OverUnder` number, nullable: The sportsbook's total points line at game start
    - `AwayTeamMoneyLine` integer, nullable: The sportsbook's moneyline for the away team
    - `HomeTeamMoneyLine` integer, nullable: The sportsbook's moneyline for the home team
    - `Updated` string, nullable: The timestamp of when this game was last updated (US Eastern Time)
    - `Created` string, nullable: The timestamp of when this game was first created (in US Eastern Time)
    - `GlobalGameID` integer: A globally unique ID for this game. Note: This value is guaranteed to be unique across all sports/leagues
    - `GlobalAwayTeamID` integer: A globally unique ID for the away team. Note: This value is guaranteed to be unique across all sports/leagues
    - `GlobalHomeTeamID` integer: A globally unique ID for the home team. Note: This value is guaranteed to be unique across all sports/leagues
    - `StadiumID` integer, nullable: The unique ID of the stadium/venue where this game was played
    - `Stadium` Stadium
      - `StadiumID` integer: The unique ID of the stadium
      - `Active` boolean: Whether or not this stadium is the home venue for an active team
      - `Name` string, nullable: The full name of the stadium
      - `Dome` boolean: Indicates whether this stadium is a dome
      - `City` string, nullable: The city where the stadium is located
      - `State` string, nullable: The US state where the stadium is located Note: if stadium is outside United States; this value is NULL
      - `GeoLat` number, nullable: The geographic latitude coordinate of this venue
      - `GeoLong` number, nullable: The geographic longitude coordinate of this venue
    - `YardLine` integer, nullable: The yard line that the ball is on at the current state of the game
    - `YardLineTerritory` string, nullable: The team's side of the field that the ball is on
    - `Down` integer, nullable: The current down
    - `Distance` integer, nullable: The current distance to a first down
    - `Possession` string, nullable: Which team currently has possession of the ball
    - `Periods` Period[]: The details of the periods (quarters & overtime) for this game
      - `PeriodID` integer: Unique ID for each period
      - `GameID` integer: The unique ID of this game
      - `Number` integer: The Number (Order) of the Period in the scope of the Game.
      - `Name` string, nullable: The name of the period (possible values: 1; 2; 3; 4; OT; Final, F/OT)
      - `AwayScore` integer, nullable: The total points scored by the away team in this period
      - `HomeScore` integer, nullable: The total points scored by the home team in this period
    - `IsClosed` boolean: Indicates whether the game is over and the final score has been verified
    - `GameEndDateTime` string, nullable: The date and time that the game ended (in US Eastern Time)
    - `Title` string, nullable: The title of the game (e.g. Rose Bowl, Citrus Bowl, etc)
    - `HomeRotationNumber` integer, nullable: Rotation number of home team for this game
    - `AwayRotationNumber` integer, nullable: Rotation number of away team for this game
    - `Channel` string, nullable: The television station broadcasting the game
    - `NeutralVenue` boolean, nullable: Indicates whether this game is played in a neutral venue
    - `AwayPointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the away team
    - `HomePointSpreadPayout` integer, nullable: The point spread payout for the home team
    - `OverPayout` integer, nullable: The sportsbook's payout for the over in the total points line
    - `UnderPayout` integer, nullable: The sportsbook's payout for the under
    - `DateTimeUTC` string, nullable: The date and time of the game (in UTC)
    - `Attendance` integer, nullable: The total number of people who attended the game
    - `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 unique ID of the team's opponent
    - `Opponent` string, nullable: The abreviation [Key] of the opponent team
    - `Wins` integer: 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: 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: 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 by the team 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: Total number of 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 scored by the team
    - `AverageOpponentScore` number, nullable: The average points scored by the opposing team

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/sportsdata/apis/cfb-api.md) - [All operations](https://skmtc.dev/sportsdata/apis/cfb-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sportsdata/apis/cfb-api/revisions/2937cc5c9322?raw)
