Skip to content

Retrieving Market Odds for Upcoming Player Predictions#

The following describes how to retrieve the market odds information for players.

Related APIS

Method Description Availability
GET /{sport}/v2/events All Leagues
GET /{sport}/v2/markets/events/{event_uuid}/performances NBA NCAAMB

Note

Market odds are only available for select players based on results form sports books. We do not provide market odds for all players.

First, lets load an upcoming Basketball event;

GET https://api.quarter4.io/basketball/v2/events?startDate[after]=2022-04-21&order[startDate]=asc&include=winloss&count=1

The preceding query includes a few options to limit results. First, we filter to a startDate to start after a specific date (use today's date for best results) and then we order by startDate asc ending with a count of 1 to get only the next event for this example.

The result includes the following, which indicates the event's UUID (example shortened):

{
  "data": [
    {
      "id": "\/basketball\/v2\/events\/2fd01692-d10c-4f18-b81e-74f48e54611e",
      "type": "Event",
       "attributes": {
        "uuid": "2fd01692-d10c-4f18-b81e-74f48e54611e"
      }
    }
  ]
}

This indicates the event's uuid is 2fd01692-d10c-4f18-b81e-74f48e54611e. You can then use this to lookup the predictions by event:

GET https://api.quarter4.io/basketball/v2/markets/events/2fd01692-d10c-4f18-b81e-74f48e54611e/performances?count=1

Which results in a list of available market performance predictions for the players the event such as this:

{
  "data": [
    {
      "id": "\/basketball\/v2\/performance_markets\/691b35ea-ff80-386c-8bac-3c81a0666c8b",
      "type": "PerformanceMarket",
      "attributes": {
        "uuid": "691b35ea-ff80-386c-8bac-3c81a0666c8b",
        "marketLines": {
          "points": {
            "markets": {
              "DraftKings": 25.5,
              "MGM": 25.5
            }
          },
          "steals": {
            "markets": {
              "MGM": 0.5,
              "WilliamHillNewJersey": 0.5
            }
          },
          "blocks": {
            "markets": {
              "MGM": 1.5,
              "WilliamHillNewJersey": 2.5
            }
          },
          "turnovers": {
            "markets": {
              "MGM": 2.5,
              "WilliamHillNewJersey": 2.5
            }
          },
          "assists": {
            "markets": {
              "DraftKings": 3.5,
              "MGM": 3.5
            }
          },
          "3-point": {
            "markets": {
              "DraftKings": 1.5,
              "MGM": 1.5
            }
          },
          "rebounds": {
            "markets": {
              "DraftKings": 10.5,
              "MGM": 10.5
            }
          }
        },
        "position": "C",
        "pointsProbOver": 0.458745,
        "pointsProbUnder": 0.541255,
        "stealsProbOver": 0.536984,
        "stealsProbUnder": 0.463016,
        "blocksProbOver": 0.313864,
        "blocksProbUnder": 0.686136,
        "turnoversProbOver": 0.527431,
        "turnoversProbUnder": 0.472569,
        "assistsProbOver": 0.440957,
        "assistsProbUnder": 0.559043,
        "threePointsMadeProbOver": 0.445559,
        "threePointsMadeProbUnder": 0.554441,
        "reboundsProbOver": 0.487051,
        "reboundsProbUnder": 0.512949,
        "forecastPoints": 20.7168,
        "forecastThreePointsMade": 1.56291,
        "forecastRebounds": 10.686,
        "forecastAssists": 3.66133,
        "forecastTurnovers": 2.60644,
        "forecastSteals": 1.16648,
        "forecastBlocks": 1.40235,
        "marketAvgPointsTotal": 25.5,
        "marketAvg3PointTotal": 1.5,
        "marketAvgReboundsTotal": 10.5,
        "marketAvgAssistsTotal": 3.5,
        "marketAvgTurnoversTotal": 2.5,
        "marketAvgStealsTotal": 0.5,
        "marketAvgBlocksTotal": 2
      },
      "relationships": {
        "player": {
          "data": {
            "type": "Player",
            "id": "\/basketball\/v2\/players\/aa58e424-6a12-4d22-93c6-6acfed54ac63"
          }
        },
        "event": {
          "data": {
            "type": "Event",
            "id": "\/basketball\/v2\/events\/2fd01692-d10c-4f18-b81e-74f48e54611e"
          }
        },
        "team": {
          "data": {
            "type": "Team",
            "id": "\/basketball\/v2\/teams\/e293ad76-3296-4429-adac-528f4ff463f4"
          }
        }
      }
    }
  ]
}

From this, you can determine our forecast (forecast*) prediction values, the market average (marketAvg*) values, as well as the Over/Under probabilities (*ProbOver/*ProbUnder) of each of the market props. Available market lines used for the predictions are included in marketLines.

Refer to the particular sport API reference for additional endpoints related to market odds.