---
title: "Betting Trends - by Matchup"
method: GET
path: "/v3/cbb/odds/{format}/MatchupTrends/{team}/{opponent}"
tags: ["CBB v3 Odds"]
---

# Betting Trends - by Matchup

`GET /v3/cbb/odds/{format}/MatchupTrends/{team}/{opponent}`

## Request

- Base URL: `https://api.sportsdata.io`
- URL: `https://api.sportsdata.io/v3/cbb/odds/{format}/MatchupTrends/{team}/{opponent}`
- Auth: one of:
  - API key in header `Ocp-Apim-Subscription-Key`
  - API key in query parameter `key`
- TypeScript: <https://skmtc.dev/sportsdata/apis/cbb-api/docs/v3/cbb/odds/:format/MatchupTrends/:team/:opponent/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns trends data for a given pairing of teams. Will return data even if the teams are not set to play this season. Intended for use on a specific game though it will work for other comparisons if applicable.

## Path parameters

- `format` 'JSON' | 'XML', required
- `team` string, required
- `opponent` string, required

## Response `200`

Success

- MatchupTrends
  - `UpcomingGame` Game
    - `GameID` integer: The unique ID of this game
    - `Season` integer: The season that the game occurs in. Note: season is a single year that the majority of the season occurs in
    - `SeasonType` integer: The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar).
    - `Status` string, nullable: Indicates the game's status. Possible values include: Scheduled, InProgress, Final, F/OT, Suspended, Postponed, Delayed, Canceled, Forfeit
    - `Day` string, nullable: The day that the game is scheduled to be played in
    - `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, nullable: The unique ID of the away team
    - `HomeTeamID` integer, nullable: The unique ID of the home team
    - `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)
    - `Period` string, nullable: The current period of the game (Possible Values: 1; 2; Half; OT; NULL)
    - `TimeRemainingMinutes` integer, nullable: Number of minutes remaining in the half (from 0 to 20). Note: if game is scheduled or final this field is NULL
    - `TimeRemainingSeconds` integer, nullable: Number of seconds remaining in the half (from 0 to 59). Note: if game is scheduled or final this field is NULL
    - `PointSpread` number, nullable: The consensus Point Spread at game start from the perspective of the HomeTeam (in the Game table, the PointSpread field's negative numbers indicate the HomeTeam is favored; positive numbers indicate the AwayTeam is favored. Note that this rule does not hold in betting-related tables, where the spread is contingent on the bet line.)
    - `OverUnder` number, nullable: The total points line (over/under) as given by the sportsbook
    - `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, 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.
    - `TournamentID` integer, nullable: The unique ID of the tournament. Note: this field is specific to the NCAA tournament & does not include other tournaments
    - `Bracket` string, nullable: The specific bracket of the tournament (e.g. East; West; Midwest; South). Note: this is specific to the NCAA tournament
    - `Round` integer, nullable: The current round of the NCAA tournament. Rounds: 1 = Round of 64, 2 = Round of 32, 3 = Sweet Sixteen, 4 = Elite Eight, 5 = Final Four, 6 = Championship Note: First Four games Round = NULL
    - `AwayTeamSeed` integer, nullable: The seed of the away team (1-16). Note: this is specific to the NCAA tournament & does not include other tournaments
    - `HomeTeamSeed` integer, nullable: The seed of the home team (1-16). Note: this is specific to the NCAA tournament & does not include other tournaments
    - `AwayTeamPreviousGameID` integer, nullable: The Id of one of the NCAA tournament games which feeds this game. This gameid will be inaccurate/invalid in free trial as it is scrambled. Null for some Round 1 and all play-in games. Used for rendering. Does not change after tournament records have been created.
    - `HomeTeamPreviousGameID` integer, nullable: The Id of one of the NCAA tournament games which feeds this game. This gameid will be inaccurate/invalid in free trial as it is scrambled. Null for some Round 1 and all play-in games. Used for rendering. Does not change after tournament records have been created.
    - `AwayTeamPreviousGlobalGameID` integer, nullable: The unique global ID of the away team's previous game (This gameid will be inaccurate/invalid in free trial as it is scrambled)
    - `HomeTeamPreviousGlobalGameID` integer, nullable: The unique global ID of the away team's previous game (This gameid will be inaccurate/invalid in free trial as it is scrambled)
    - `TournamentDisplayOrder` integer, nullable: The display order of this game. This is used for rendering NCAA Tournament bracket.
    - `TournamentDisplayOrderForHomeTeam` string, nullable: The display order of the home team for this game. This is used for rendering the NCAA Tournament bracket, and it indicates whether the home team should be displayed at the top or bottom of the game card. Possible values: Top, Bottom
    - `Periods` Period[]: The details of the periods (halves & overtime) for this game. Note: the scores are for that half/period only, not total score of game at that point
      - `PeriodID` integer: The unique ID for the 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 in the game (e.g. 1, 2, OT, OT2, etc.)
      - `Type` string, nullable: Indicates whether this period is the first/second half or overtime (possible values: Half, Overtime)
      - `AwayScore` integer, nullable: The total points scored by the away team in this period only
      - `HomeScore` integer, nullable: The total points scored by the home team in this period only
    - `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
    - `GameEndDateTime` string, nullable: The date and time that the game ended (in US Eastern Time)
    - `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. Note: Active = True & Inactive = False
      - `Name` string, nullable: The full name of the stadium
      - `Address` string, nullable: The address where the stadium is located (street name). Note: some stadiums will not have an address field
      - `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 US; this value is NULL
      - `Zip` string, nullable: The zip code of the stadium
      - `Country` string, nullable: The 3-letter country abbreviation where the stadium is located
      - `Capacity` integer, nullable: The estimated seating capacity of the stadium
      - `GeoLat` number, nullable: The geographic latitude coordinate of this venue.
      - `GeoLong` number, nullable: The geographic longitude coordinate of this venue.
    - `HomeRotationNumber` integer, nullable: Rotation number of home team for this game
    - `AwayRotationNumber` integer, nullable: Rotation number of away team for this game.
    - `TopTeamPreviousGameId` integer, nullable: Previous game id of the team in the top slot of an NCAA tournament game. Used for rendering.
    - `BottomTeamPreviousGameId` integer, nullable: Previous game id of the team in the bottom slot of an NCAA tournament game. Used for rendering.
    - `Channel` string, nullable: The television station broadcasting the game
    - `NeutralVenue` boolean, nullable: Indicates whether this game is played in a neutral venue. Note: Neutral = True, Not Neutral = False
    - `AwayPointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the away team. Note: this line is a consensus
    - `HomePointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the home team
    - `OverPayout` integer, nullable: The odds at which the sportsbook will pay out winning over bets at
    - `UnderPayout` integer, nullable: The payout when betting the Under of the Over/Under
    - `DateTimeUTC` string, nullable: The date and time of the game in UTC
    - `Attendance` integer, nullable: The attendance of the game when available
    - `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.
  - `TeamTrends` TeamTrends[]: The collection of team trends between each team
    - `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 season that the game occurs in. Note: season is a single year that the majority of the season occurs in
      - `SeasonType` integer: The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar).
      - `Status` string, nullable: Indicates the game's status. Possible values include: Scheduled, InProgress, Final, F/OT, Suspended, Postponed, Delayed, Canceled, Forfeit
      - `Day` string, nullable: The day that the game is scheduled to be played in
      - `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, nullable: The unique ID of the away team
      - `HomeTeamID` integer, nullable: The unique ID of the home team
      - `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)
      - `Period` string, nullable: The current period of the game (Possible Values: 1; 2; Half; OT; NULL)
      - `TimeRemainingMinutes` integer, nullable: Number of minutes remaining in the half (from 0 to 20). Note: if game is scheduled or final this field is NULL
      - `TimeRemainingSeconds` integer, nullable: Number of seconds remaining in the half (from 0 to 59). Note: if game is scheduled or final this field is NULL
      - `PointSpread` number, nullable: The consensus Point Spread at game start from the perspective of the HomeTeam (in the Game table, the PointSpread field's negative numbers indicate the HomeTeam is favored; positive numbers indicate the AwayTeam is favored. Note that this rule does not hold in betting-related tables, where the spread is contingent on the bet line.)
      - `OverUnder` number, nullable: The total points line (over/under) as given by the sportsbook
      - `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, 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.
      - `TournamentID` integer, nullable: The unique ID of the tournament. Note: this field is specific to the NCAA tournament & does not include other tournaments
      - `Bracket` string, nullable: The specific bracket of the tournament (e.g. East; West; Midwest; South). Note: this is specific to the NCAA tournament
      - `Round` integer, nullable: The current round of the NCAA tournament. Rounds: 1 = Round of 64, 2 = Round of 32, 3 = Sweet Sixteen, 4 = Elite Eight, 5 = Final Four, 6 = Championship Note: First Four games Round = NULL
      - `AwayTeamSeed` integer, nullable: The seed of the away team (1-16). Note: this is specific to the NCAA tournament & does not include other tournaments
      - `HomeTeamSeed` integer, nullable: The seed of the home team (1-16). Note: this is specific to the NCAA tournament & does not include other tournaments
      - `AwayTeamPreviousGameID` integer, nullable: The Id of one of the NCAA tournament games which feeds this game. This gameid will be inaccurate/invalid in free trial as it is scrambled. Null for some Round 1 and all play-in games. Used for rendering. Does not change after tournament records have been created.
      - `HomeTeamPreviousGameID` integer, nullable: The Id of one of the NCAA tournament games which feeds this game. This gameid will be inaccurate/invalid in free trial as it is scrambled. Null for some Round 1 and all play-in games. Used for rendering. Does not change after tournament records have been created.
      - `AwayTeamPreviousGlobalGameID` integer, nullable: The unique global ID of the away team's previous game (This gameid will be inaccurate/invalid in free trial as it is scrambled)
      - `HomeTeamPreviousGlobalGameID` integer, nullable: The unique global ID of the away team's previous game (This gameid will be inaccurate/invalid in free trial as it is scrambled)
      - `TournamentDisplayOrder` integer, nullable: The display order of this game. This is used for rendering NCAA Tournament bracket.
      - `TournamentDisplayOrderForHomeTeam` string, nullable: The display order of the home team for this game. This is used for rendering the NCAA Tournament bracket, and it indicates whether the home team should be displayed at the top or bottom of the game card. Possible values: Top, Bottom
      - `Periods` Period[]: The details of the periods (halves & overtime) for this game. Note: the scores are for that half/period only, not total score of game at that point
        - `PeriodID` integer: The unique ID for the 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 in the game (e.g. 1, 2, OT, OT2, etc.)
        - `Type` string, nullable: Indicates whether this period is the first/second half or overtime (possible values: Half, Overtime)
        - `AwayScore` integer, nullable: The total points scored by the away team in this period only
        - `HomeScore` integer, nullable: The total points scored by the home team in this period only
      - `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
      - `GameEndDateTime` string, nullable: The date and time that the game ended (in US Eastern Time)
      - `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. Note: Active = True & Inactive = False
        - `Name` string, nullable: The full name of the stadium
        - `Address` string, nullable: The address where the stadium is located (street name). Note: some stadiums will not have an address field
        - `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 US; this value is NULL
        - `Zip` string, nullable: The zip code of the stadium
        - `Country` string, nullable: The 3-letter country abbreviation where the stadium is located
        - `Capacity` integer, nullable: The estimated seating capacity of the stadium
        - `GeoLat` number, nullable: The geographic latitude coordinate of this venue.
        - `GeoLong` number, nullable: The geographic longitude coordinate of this venue.
      - `HomeRotationNumber` integer, nullable: Rotation number of home team for this game
      - `AwayRotationNumber` integer, nullable: Rotation number of away team for this game.
      - `TopTeamPreviousGameId` integer, nullable: Previous game id of the team in the top slot of an NCAA tournament game. Used for rendering.
      - `BottomTeamPreviousGameId` integer, nullable: Previous game id of the team in the bottom slot of an NCAA tournament game. Used for rendering.
      - `Channel` string, nullable: The television station broadcasting the game
      - `NeutralVenue` boolean, nullable: Indicates whether this game is played in a neutral venue. Note: Neutral = True, Not Neutral = False
      - `AwayPointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the away team. Note: this line is a consensus
      - `HomePointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the home team
      - `OverPayout` integer, nullable: The odds at which the sportsbook will pay out winning over bets at
      - `UnderPayout` integer, nullable: The payout when betting the Under of the Over/Under
      - `DateTimeUTC` string, nullable: The date and time of the game in UTC
      - `Attendance` integer, nullable: The attendance of the game when available
      - `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 range in which the trend shows data for (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: The total number of wins by the team relating to the scope (conference & non-conference)
      - `Losses` integer: The total number of losses by the team relating to the scope (conference & non-conference)
      - `Ties` integer: The total number of ties by the team relating to the scope (conference & non-conference)
      - `WinsAgainstTheSpread` integer, nullable: How many games the given team has covered the spread in relating to the scope of the search
      - `LossesAgainstTheSpread` integer, nullable: The total number of losses against the point spread by the team relating to the scope (conference & non-conference
      - `PushesAgainstTheSpread` integer, nullable: The amount of times a given team's final score of their game has pushed the point spread (a push is neither a win nor a loss)
      - `Overs` integer, nullable: The amount of times a given team's final score of their game has gone over the point total (Over/Under) relating to the scope
      - `Unders` integer, nullable: Amount of times the total score goes under the OverUnder
      - `OverUnderPushes` integer, nullable: The amount of times a given team's final score of their game has pushed the total points line (a push is neither a win nor a loss)
      - `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.)
  - `TeamMatchupTrends` TeamGameTrends[]: The collection of team game trends against opponent
    - `Scope` string, nullable: The range in which the trend shows data for (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: The total number of wins by the team relating to the scope (conference & non-conference)
    - `Losses` integer: The total number of losses by the team relating to the scope (conference & non-conference)
    - `Ties` integer: The total number of ties by the team relating to the scope (conference & non-conference)
    - `WinsAgainstTheSpread` integer, nullable: How many games the given team has covered the spread in relating to the scope of the search
    - `LossesAgainstTheSpread` integer, nullable: The total number of losses against the point spread by the team relating to the scope (conference & non-conference
    - `PushesAgainstTheSpread` integer, nullable: The amount of times a given team's final score of their game has pushed the point spread (a push is neither a win nor a loss)
    - `Overs` integer, nullable: The amount of times a given team's final score of their game has gone over the point total (Over/Under) relating to the scope
    - `Unders` integer, nullable: Amount of times the total score goes under the OverUnder
    - `OverUnderPushes` integer, nullable: The amount of times a given team's final score of their game has pushed the total points line (a push is neither a win nor a loss)
    - `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.)
  - `OpponentMatchupTrends` TeamGameTrends[]: The collection of opponent game trends against team
    - `Scope` string, nullable: The range in which the trend shows data for (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: The total number of wins by the team relating to the scope (conference & non-conference)
    - `Losses` integer: The total number of losses by the team relating to the scope (conference & non-conference)
    - `Ties` integer: The total number of ties by the team relating to the scope (conference & non-conference)
    - `WinsAgainstTheSpread` integer, nullable: How many games the given team has covered the spread in relating to the scope of the search
    - `LossesAgainstTheSpread` integer, nullable: The total number of losses against the point spread by the team relating to the scope (conference & non-conference
    - `PushesAgainstTheSpread` integer, nullable: The amount of times a given team's final score of their game has pushed the point spread (a push is neither a win nor a loss)
    - `Overs` integer, nullable: The amount of times a given team's final score of their game has gone over the point total (Over/Under) relating to the scope
    - `Unders` integer, nullable: Amount of times the total score goes under the OverUnder
    - `OverUnderPushes` integer, nullable: The amount of times a given team's final score of their game has pushed the total points line (a push is neither a win nor a loss)
    - `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.)
  - `PreviousGames` Game[]: The collection of last 10 game scores between each team
    - `GameID` integer: The unique ID of this game
    - `Season` integer: The season that the game occurs in. Note: season is a single year that the majority of the season occurs in
    - `SeasonType` integer: The type of season that this record corresponds to (1=Regular Season, 2=Preseason, 3=Postseason, 4=Offseason, 5=AllStar).
    - `Status` string, nullable: Indicates the game's status. Possible values include: Scheduled, InProgress, Final, F/OT, Suspended, Postponed, Delayed, Canceled, Forfeit
    - `Day` string, nullable: The day that the game is scheduled to be played in
    - `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, nullable: The unique ID of the away team
    - `HomeTeamID` integer, nullable: The unique ID of the home team
    - `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)
    - `Period` string, nullable: The current period of the game (Possible Values: 1; 2; Half; OT; NULL)
    - `TimeRemainingMinutes` integer, nullable: Number of minutes remaining in the half (from 0 to 20). Note: if game is scheduled or final this field is NULL
    - `TimeRemainingSeconds` integer, nullable: Number of seconds remaining in the half (from 0 to 59). Note: if game is scheduled or final this field is NULL
    - `PointSpread` number, nullable: The consensus Point Spread at game start from the perspective of the HomeTeam (in the Game table, the PointSpread field's negative numbers indicate the HomeTeam is favored; positive numbers indicate the AwayTeam is favored. Note that this rule does not hold in betting-related tables, where the spread is contingent on the bet line.)
    - `OverUnder` number, nullable: The total points line (over/under) as given by the sportsbook
    - `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, 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.
    - `TournamentID` integer, nullable: The unique ID of the tournament. Note: this field is specific to the NCAA tournament & does not include other tournaments
    - `Bracket` string, nullable: The specific bracket of the tournament (e.g. East; West; Midwest; South). Note: this is specific to the NCAA tournament
    - `Round` integer, nullable: The current round of the NCAA tournament. Rounds: 1 = Round of 64, 2 = Round of 32, 3 = Sweet Sixteen, 4 = Elite Eight, 5 = Final Four, 6 = Championship Note: First Four games Round = NULL
    - `AwayTeamSeed` integer, nullable: The seed of the away team (1-16). Note: this is specific to the NCAA tournament & does not include other tournaments
    - `HomeTeamSeed` integer, nullable: The seed of the home team (1-16). Note: this is specific to the NCAA tournament & does not include other tournaments
    - `AwayTeamPreviousGameID` integer, nullable: The Id of one of the NCAA tournament games which feeds this game. This gameid will be inaccurate/invalid in free trial as it is scrambled. Null for some Round 1 and all play-in games. Used for rendering. Does not change after tournament records have been created.
    - `HomeTeamPreviousGameID` integer, nullable: The Id of one of the NCAA tournament games which feeds this game. This gameid will be inaccurate/invalid in free trial as it is scrambled. Null for some Round 1 and all play-in games. Used for rendering. Does not change after tournament records have been created.
    - `AwayTeamPreviousGlobalGameID` integer, nullable: The unique global ID of the away team's previous game (This gameid will be inaccurate/invalid in free trial as it is scrambled)
    - `HomeTeamPreviousGlobalGameID` integer, nullable: The unique global ID of the away team's previous game (This gameid will be inaccurate/invalid in free trial as it is scrambled)
    - `TournamentDisplayOrder` integer, nullable: The display order of this game. This is used for rendering NCAA Tournament bracket.
    - `TournamentDisplayOrderForHomeTeam` string, nullable: The display order of the home team for this game. This is used for rendering the NCAA Tournament bracket, and it indicates whether the home team should be displayed at the top or bottom of the game card. Possible values: Top, Bottom
    - `Periods` Period[]: The details of the periods (halves & overtime) for this game. Note: the scores are for that half/period only, not total score of game at that point
      - `PeriodID` integer: The unique ID for the 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 in the game (e.g. 1, 2, OT, OT2, etc.)
      - `Type` string, nullable: Indicates whether this period is the first/second half or overtime (possible values: Half, Overtime)
      - `AwayScore` integer, nullable: The total points scored by the away team in this period only
      - `HomeScore` integer, nullable: The total points scored by the home team in this period only
    - `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
    - `GameEndDateTime` string, nullable: The date and time that the game ended (in US Eastern Time)
    - `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. Note: Active = True & Inactive = False
      - `Name` string, nullable: The full name of the stadium
      - `Address` string, nullable: The address where the stadium is located (street name). Note: some stadiums will not have an address field
      - `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 US; this value is NULL
      - `Zip` string, nullable: The zip code of the stadium
      - `Country` string, nullable: The 3-letter country abbreviation where the stadium is located
      - `Capacity` integer, nullable: The estimated seating capacity of the stadium
      - `GeoLat` number, nullable: The geographic latitude coordinate of this venue.
      - `GeoLong` number, nullable: The geographic longitude coordinate of this venue.
    - `HomeRotationNumber` integer, nullable: Rotation number of home team for this game
    - `AwayRotationNumber` integer, nullable: Rotation number of away team for this game.
    - `TopTeamPreviousGameId` integer, nullable: Previous game id of the team in the top slot of an NCAA tournament game. Used for rendering.
    - `BottomTeamPreviousGameId` integer, nullable: Previous game id of the team in the bottom slot of an NCAA tournament game. Used for rendering.
    - `Channel` string, nullable: The television station broadcasting the game
    - `NeutralVenue` boolean, nullable: Indicates whether this game is played in a neutral venue. Note: Neutral = True, Not Neutral = False
    - `AwayPointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the away team. Note: this line is a consensus
    - `HomePointSpreadPayout` integer, nullable: The sportsbook's point spread payout for the home team
    - `OverPayout` integer, nullable: The odds at which the sportsbook will pay out winning over bets at
    - `UnderPayout` integer, nullable: The payout when betting the Under of the Over/Under
    - `DateTimeUTC` string, nullable: The date and time of the game in UTC
    - `Attendance` integer, nullable: The attendance of the game when available
    - `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.

## Other responses

- `401`: Unauthorized

## Changes

- **2026-11-07** `2bf9419ae396`: 3 info
  - added the optional property `PreviousGames/items/Deleted` to the response with the `200` status
  - added the optional property `TeamTrends/items/UpcomingGame/Deleted` to the response with the `200` status
  - added the optional property `UpcomingGame/Deleted` to the response with the `200` status

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

---

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