MarketSelection Historic Data Object

{
  "event": {
    "id": "EVNT_034db3a5675e4b7296f25fd3e6f66710",
    "startTime": "2024-01-15T01:00:00Z",
    "league": "NBA",
    "contestantHome": {
      "id": "TEAM_8bfd1dfe1a09451195d19c792ea18567",
      "name": "Celtics",
      "fullName": "Boston Celtics"
    },
    "contestantAway": {
      "id": "TEAM_4c55dc8e7a3b4b21b0509d93b49f8a33",
      "name": "Lakers",
      "fullName": "Los Angeles Lakers"
    }
  },
  "team": {
    "id": "TEAM_4c55dc8e7a3b4b21b0509d93b49f8a33",
    "name": "Lakers",
    "fullName": "Los Angeles Lakers"
  },
  "opponent": {
    "id": "TEAM_8bfd1dfe1a09451195d19c792ea18567",
    "name": "Celtics",
    "fullName": "Boston Celtics"
  },
  "locationType": "Away",
  "player": {
    "id": "PLYR_lebron_james_2544",
    "firstName": "LeBron",
    "lastName": "James"
  },
  "market": {
    "id": "MKT_66072c73020447638eeed55d0313c0db",
    "name": "Player Prop Total Points"
  },
  "position": "Over",
  "DVP": 15.2,
  "dvpRank": 5,
  "dvpAvg": 14.8,
  "dvpPosition": "SF",
  "consensusProjection": 26.5,
  "venue": {
    "name": "TD Garden",
    "parkFactorRank": 15,
    "parkFactorPerc": 102.1
  },
  "startingPitcher": {
    "id": "PLYR_gerrit_cole_571",
    "firstName": "Gerrit",
    "lastName": "Cole",
    "hand": "R"
  },
  "gameStats": [
    {
      "season": "2023-2024",
      "location": "away",
      "value": 28.0,
      "date": "2024-01-10T01:00:00Z",
      "result": "Over",
      "opponent": {
        "id": "TEAM_miami_heat_456",
        "name": "Heat",
        "fullName": "Miami Heat"
      },
      "dvpRank": 18,
      "venue": {
        "name": "FTX Arena",
        "parkFactorRank": 22,
        "parkFactorPerc": 98.5
      },
      "position": "SF"
    },
    {
      "season": "2023-2024",
      "location": "home",
      "value": 22.0,
      "date": "2024-01-08T02:30:00Z",
      "result": "Under",
      "opponent": {
        "id": "TEAM_denver_nuggets_789",
        "name": "Nuggets",
        "fullName": "Denver Nuggets"
      },
      "dvpRank": 3,
      "venue": {
        "name": "Crypto.com Arena",
        "parkFactorRank": 8,
        "parkFactorPerc": 104.2
      },
      "position": "SF"
    },
    {
      "season": "2023-2024",
      "location": "home",
      "value": 31.0,
      "date": "2024-01-05T03:00:00Z",
      "result": "Over",
      "opponent": {
        "id": "TEAM_phoenix_suns_321",
        "name": "Suns",
        "fullName": "Phoenix Suns"
      },
      "dvpRank": 25,
      "venue": {
        "name": "Crypto.com Arena",
        "parkFactorRank": 8,
        "parkFactorPerc": 104.2
      },
      "position": "SF"
    }
  ],
  "bestPrice": {
    "line": 26.5,
    "price": -110,
    "book": {
      "id": "BOOK_pPg9ABaPSj2mL6qoMTKR1A",
      "name": "DraftKings",
      "abbr": "dk"
    }
  }
}

Endpoints

📈 marketSelection historic data

event (object)

Event details for the upcoming game where this market selection applies.

id (string)

Unique identifier for the event with format EVNT_*.

startTime (string)

ISO 8601 formatted start time of the upcoming event.

league (string)

League abbreviation (e.g., "NBA", "NFL", "MLB").

contestantHome (object)

Home team details including team ID, name, and full name.

contestantAway (object)

Away team details including team ID, name, and full name.

team (object)

The team associated with this market selection (for player props, this is the player's team).

id (string)

Unique team identifier with format TEAM_*.

name (string)

Team short name.

fullName (string)

Team full display name.

opponent (object)

The opposing team for this market selection.

id (string)

Unique team identifier with format TEAM_*.

name (string)

Team short name.

fullName (string)

Team full display name.

locationType (string)

Indicates whether the team is playing at home or away for the upcoming game. Values: "Home" or "Away".

player (object)

Player details for player prop bets. Only present for player proposition markets.

id (string)

Unique player identifier with format PLYR_*.

firstName (string)

Player first name.

lastName (string)

Player last name.

market (object)

Market details for this selection.

id (string)

Unique market identifier with format MKT_*.

name (string)

Market display name (e.g., "Player Prop Total Points", "Team Total Points").

position (string)

The betting position for this selection. Values: "Over" or "Under".

DVP (float|null)

Current Defense vs Position value - opponent's defensive performance against this player's position. Lower values indicate stronger defense.

dvpRank (integer|null)

Current opponent's league ranking for defense against this position (1 = best defense).

dvpAvg (float|null)

League average for the statistical category being measured.

dvpPosition (string)

Player position used for DVP calculation (e.g., "PG", "SF", "QB", "RB").

consensusProjection (float|null)

Consensus projection value for this market from various sportsbooks and prediction models.

venue (object)

Venue information for the upcoming event (primarily used for MLB).

name (string)

Venue display name.

parkFactorRank (integer)

Venue ranking for park factor (1 = most hitter-friendly).

parkFactorPerc (float)

Park factor percentage indicating how the venue affects scoring (100 = neutral, >100 = hitter-friendly).

startingPitcher (object)

Starting pitcher information for the upcoming game (MLB only).

id (string)

Unique player identifier for the starting pitcher.

firstName (string)

Starting pitcher first name.

lastName (string)

Starting pitcher last name.

hand (string)

Pitcher handedness. Values: "L" (left) or "R" (right).

gameStats (array)

Historical game-by-game performance data for this player in this statistical category. Each game shows the player's actual performance and whether it would have hit the Over or Under.

season (string)

Season identifier for this game (e.g., "2023-2024").

location (string)

Location where this historical game was played. Values: "home" or "away".

value (float)

Player's actual statistical performance in this category for this game.

date (string)

ISO 8601 formatted date/time when this historical game was played.

result (string)

Whether the player's performance would have hit the Over or Under based on the current betting line. Values: "Over" or "Under".

opponent (object)

Opponent team details for this historical game, including team ID, name, and full name.

dvpRank (integer|null)

The opponent's DVP ranking at the time of this historical game.

venue (object)

Venue information for this historical game (MLB only), including name, park factor rank, and park factor percentage.

position (string)

Player's position during this historical game.

bestPrice (object)

Best available pricing information if no line parameter was provided in the request.

line (float)

The betting line value used for Over/Under calculations in gameStats.

price (integer)

American odds for this position at the best available book.

book (object)

Sportsbook details providing the best price, including book ID, name, and abbreviation.