---
title: "In-Game Odds - by Date"
method: GET
path: "/v3/mlb/odds/{format}/LiveGameOddsByDate/{date}"
tags: ["MLB v3 Odds"]
---

# In-Game Odds - by Date

`GET /v3/mlb/odds/{format}/LiveGameOddsByDate/{date}`

## Request

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

Returns in-play game odds (spread, moneyline, total) for games on a given date. Only returns the most recently seen odds, not inclusive of line movement. As this is in-game, it will only return results while the game is in progress.

## Path parameters

- `format` 'JSON' | 'XML', required
- `date` string, required

## Response `200`

Success

- GameInfo[]
  - `GameId` integer: The unique ID of this game
  - `Season` integer: The MLB 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).
  - `Day` string, nullable: The day of the game
  - `DateTime` string, nullable: The date and time of the game in US Eastern Time
  - `Status` string, nullable: The status of the game. For a description of possible values, see <a href="https://sportsdata.io/help/faq#what-are-all-of-the-game-statuses-used-across-sports" target="_blank">here.</a> For how suspended and postponed games are handled specifically, see <a href="https://sportsdata.io/help/faq#how-do-you-handle-postponed-suspended-and-canceled-games" target="_blank">here</a>.
  - `AwayTeamId` integer, nullable: The unique TeamID of the away team
  - `HomeTeamId` integer, nullable: The unique ID of the home team
  - `AwayTeamName` string, nullable: The abbreviation [Key] of the away team
  - `HomeTeamName` string, nullable: The abbreviation [Key] 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.
  - `PregameOdds` GameOdd[]: List of Pregame GameOdds from different sportsbooks
    - `GameOddId` integer: Unique ID of this odd
    - `Sportsbook` string, nullable: Name of sportsbook
    - `GameId` integer: The unique ID of this game
    - `Created` string, nullable: The date and time when these odds were first created in US Eastern Time
    - `Updated` string, nullable: The date and time of when these odds were last updated (in US Eatern Time) If these are the latest odds for this game; and they have not been updated within the last few minutes; then it indicates that there were problems connecting to the sportsbook.
    - `HomeMoneyLine` integer, nullable: The sportsbook's moneyline for the home team
    - `AwayMoneyLine` integer, nullable: The sportsbook's moneyline for the away team
    - `HomePointSpread` number, nullable: The sportsbook's run line for the home team
    - `AwayPointSpread` number, nullable: The sportsbook's run line for the away team
    - `HomePointSpreadPayout` integer, nullable: The sportsbook's run line payout for the home team
    - `AwayPointSpreadPayout` integer, nullable: The sportsbook's run line payout for the away team
    - `OverUnder` number, nullable: The total points line as given by the sportsbook
    - `OverPayout` integer, nullable: The sportsbook's payout for the over
    - `UnderPayout` integer, nullable: The sportsbook's payout for the under
    - `SportsbookId` integer, nullable: Unique ID of the sportsbook
    - `SportsbookUrl` string, nullable: The URL for sportsbook event
    - `OddType` string, nullable: The market type of the odd (ex: live; pregame; 1st inning; etc)
    - `Unlisted` string, nullable: The timestamp of when these odds were first made unavailable to be bet on any further (In US Eastern Time)
  - `LiveOdds` GameOdd[]: Shows a list of live odds from different sportsbooks
    - `GameOddId` integer: Unique ID of this odd
    - `Sportsbook` string, nullable: Name of sportsbook
    - `GameId` integer: The unique ID of this game
    - `Created` string, nullable: The date and time when these odds were first created in US Eastern Time
    - `Updated` string, nullable: The date and time of when these odds were last updated (in US Eatern Time) If these are the latest odds for this game; and they have not been updated within the last few minutes; then it indicates that there were problems connecting to the sportsbook.
    - `HomeMoneyLine` integer, nullable: The sportsbook's moneyline for the home team
    - `AwayMoneyLine` integer, nullable: The sportsbook's moneyline for the away team
    - `HomePointSpread` number, nullable: The sportsbook's run line for the home team
    - `AwayPointSpread` number, nullable: The sportsbook's run line for the away team
    - `HomePointSpreadPayout` integer, nullable: The sportsbook's run line payout for the home team
    - `AwayPointSpreadPayout` integer, nullable: The sportsbook's run line payout for the away team
    - `OverUnder` number, nullable: The total points line as given by the sportsbook
    - `OverPayout` integer, nullable: The sportsbook's payout for the over
    - `UnderPayout` integer, nullable: The sportsbook's payout for the under
    - `SportsbookId` integer, nullable: Unique ID of the sportsbook
    - `SportsbookUrl` string, nullable: The URL for sportsbook event
    - `OddType` string, nullable: The market type of the odd (ex: live; pregame; 1st inning; etc)
    - `Unlisted` string, nullable: The timestamp of when these odds were first made unavailable to be bet on any further (In US Eastern Time)
  - `HomeTeamScore` integer, nullable: Score of the home team (updated after game ends to allow for resolving bets)
  - `AwayTeamScore` integer, nullable: Score of the away team (updated after game ends to allow for resolving bets)
  - `TotalScore` integer, nullable: The combined scores of the home and away team of the game tied to this event (post-game)
  - `HomeRotationNumber` integer, nullable: Rotation number of home team for this game
  - `AwayRotationNumber` integer, nullable: Rotation number of away team for this game
  - `AlternateMarketPregameOdds` GameOdd[]: List of Alternate Market Game Odds from different sportsbooks.
    - `GameOddId` integer: Unique ID of this odd
    - `Sportsbook` string, nullable: Name of sportsbook
    - `GameId` integer: The unique ID of this game
    - `Created` string, nullable: The date and time when these odds were first created in US Eastern Time
    - `Updated` string, nullable: The date and time of when these odds were last updated (in US Eatern Time) If these are the latest odds for this game; and they have not been updated within the last few minutes; then it indicates that there were problems connecting to the sportsbook.
    - `HomeMoneyLine` integer, nullable: The sportsbook's moneyline for the home team
    - `AwayMoneyLine` integer, nullable: The sportsbook's moneyline for the away team
    - `HomePointSpread` number, nullable: The sportsbook's run line for the home team
    - `AwayPointSpread` number, nullable: The sportsbook's run line for the away team
    - `HomePointSpreadPayout` integer, nullable: The sportsbook's run line payout for the home team
    - `AwayPointSpreadPayout` integer, nullable: The sportsbook's run line payout for the away team
    - `OverUnder` number, nullable: The total points line as given by the sportsbook
    - `OverPayout` integer, nullable: The sportsbook's payout for the over
    - `UnderPayout` integer, nullable: The sportsbook's payout for the under
    - `SportsbookId` integer, nullable: Unique ID of the sportsbook
    - `SportsbookUrl` string, nullable: The URL for sportsbook event
    - `OddType` string, nullable: The market type of the odd (ex: live; pregame; 1st inning; etc)
    - `Unlisted` string, nullable: The timestamp of when these odds were first made unavailable to be bet on any further (In US Eastern Time)

## Other responses

- `401`: Unauthorized

---

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