Retrieving Pre-Game Event Predictions#

In the following example you will retrieve the upcoming event predictions for the next NFL game.

Related APIS

Method	Description	Availability
`GET`	/{sport}/v2/events	All Leagues
`GET`	/{sport}/v2/win_losses	All Leagues

Start By querying the /{sport}/v2/events endpoint for the next available game in the NFL. Filter by league.uuid, startDate and order:

GET https://api.quarter4.io/american-football/v2/events?startDate[after]=now&order[startDate]=asc&league.uuid=38344248-9889-11eb-a8ab-0647cdb505d0&page=1&count=1

This result contains a list of upcoming events (here limited to 1 due to the count query parameter). For example:

{
  "links": {
    "self": "\/american-football\/v2\/events?count=1\u0026include=winloss\u0026league.uuid=38344248-9889-11eb-a8ab-0647cdb505d0\u0026order%5BstartDate%5D=asc\u0026startDate%5Bafter%5D=now\u0026page=1",
    "first": "\/american-football\/v2\/events?count=1\u0026include=winloss\u0026league.uuid=38344248-9889-11eb-a8ab-0647cdb505d0\u0026order%5BstartDate%5D=asc\u0026startDate%5Bafter%5D=now\u0026page=1",
    "last": "\/american-football\/v2\/events?count=1\u0026include=winloss\u0026league.uuid=38344248-9889-11eb-a8ab-0647cdb505d0\u0026order%5BstartDate%5D=asc\u0026startDate%5Bafter%5D=now\u0026page=256",
    "next": "\/american-football\/v2\/events?count=1\u0026include=winloss\u0026league.uuid=38344248-9889-11eb-a8ab-0647cdb505d0\u0026order%5BstartDate%5D=asc\u0026startDate%5Bafter%5D=now\u0026page=2"
  },
  "meta": {
    "totalItems": 256,
    "itemsPerPage": 1,
    "currentPage": 1
  },
  "data": [
    {
      "id": "\/american-football\/v2\/events\/d2554158-f1fe-4fa2-97b5-bf7f076979d4",
      "type": "Event",
      "attributes": {
        "startDate": "2022-09-16T00:15:00+00:00",
        "eventStatus": {
          "name": "pre-game",
          "uuid": "9e840b68-5855-4f46-a7b9-7e97694258fc"
        },
        "homeTeamScore": null,
        "awayTeamScore": null,
        "title": "Los Angeles Chargers at Kansas City Chiefs",
        "homeSeed": null,
        "awaySeed": null,
        "coverage": "full",
        "otherBooksData": {
          "spread_home": {
            "MGM": "-3.5",
            "DraftKings": "-3.5",
            "FanDuel": "-3.5",
            "Westgate": "-3.5",
            "SugarHouseNJ": "-3.5",
            "PointsBet": "-3.5",
            "Bet365NewJersey": "-3.5"
          },
          "spread_away": {
            "MGM": "3.5",
            "DraftKings": "3.5",
            "FanDuel": "3.5",
            "Westgate": "3.5",
            "SugarHouseNJ": "3.5",
            "PointsBet": "3.5",
            "Bet365NewJersey": "3.5"
          },
          "over_under": {
            "MGM": "54.5",
            "DraftKings": "54.5",
            "FanDuel": "54.5",
            "Westgate": "54",
            "SugarHouseNJ": "54.5",
            "PointsBet": "54.5",
            "Bet365NewJersey": "54.5"
          }
        },
        "uuid": "d2554158-f1fe-4fa2-97b5-bf7f076979d4",
        "awayRemainingTimeouts": null,
        "clock": null,
        "displayStatus": "scheduled"
      },
      "relationships": {
        "league": {
          "data": {
            "type": "League",
            "id": "\/american-football\/v2\/leagues\/38344248-9889-11eb-a8ab-0647cdb505d0"
          }
        },
        "homeTeam": {
          "data": {
            "type": "Team",
            "id": "\/american-football\/v2\/teams\/da067403-25e8-4f40-a02e-55cda46f0b6b"
          }
        },
        "awayTeam": {
          "data": {
            "type": "Team",
            "id": "\/american-football\/v2\/teams\/499a829d-e18d-4b3a-81a8-7aad418fef95"
          }
        },
        "winloss": {
          "data": {
            "type": "WinLoss",
            "id": "\/american-football\/v2\/win_losses\/d2554158-f1fe-4fa2-97b5-bf7f076979d4"
          }
        }
      }
    }
  ]
}

To retrieve the predictions related to the event you can query the /{sport}/v2/wins_losses endpoint using the event's uuid:

GET https://api.quarter4.io/american-football/v2/win_losses/d2554158-f1fe-4fa2-97b5-bf7f076979d4?

{
  "data": {
    "id": "\/american-football\/v2\/win_losses\/d2554158-f1fe-4fa2-97b5-bf7f076979d4",
    "type": "WinLoss",
    "attributes": {
      "uuid": "d2554158-f1fe-4fa2-97b5-bf7f076979d4",
      "detail": "The Kansas City Chiefs have a 53.9% chance of beating the Los Angeles Chargers",
      "homeWinProbability": 54,
      "awayWinProbability": 46,
      "homeSpread": -1,
      "awaySpread": 1,
      "overUnder": 55.9742,
      "winLossSpreadConsistency": 1,
      "otherBooksData": {
        "spread_home": {
          "MGM": "-3.5",
          "DraftKings": "-3.5",
          "FanDuel": "-3.5",
          "Westgate": "-3.5",
          "SugarHouseNJ": "-3.5",
          "PointsBet": "-3.5",
          "Bet365NewJersey": "-3.5"
        },
        "spread_away": {
          "MGM": "3.5",
          "DraftKings": "3.5",
          "FanDuel": "3.5",
          "Westgate": "3.5",
          "SugarHouseNJ": "3.5",
          "PointsBet": "3.5",
          "Bet365NewJersey": "3.5"
        },
        "over_under": {
          "MGM": "54.5",
          "DraftKings": "54.5",
          "FanDuel": "54.5",
          "Westgate": "54",
          "SugarHouseNJ": "54.5",
          "PointsBet": "54.5",
          "Bet365NewJersey": "54.5"
        }
      },
      "overtimeProbability": 0.13286,
      "predictAsOvertime": 0,
      "homeFirstFieldGoal": 0.695565,
      "awayFirstFieldGoal": 0.304435,
      "homeFirstInterception": 0.813783,
      "awayFirstInterception": 0.186217,
      "homeFirstPenalty": 0.500814,
      "awayFirstPenalty": 0.499186,
      "homeFirstSack": 0.728931,
      "awayFirstSack": 0.271069,
      "homeFirstTouchdown": 0.687686,
      "awayFirstTouchdown": 0.312314,
      "probability": 54,
      "winnerUuid": "da067403-25e8-4f40-a02e-55cda46f0b6b",
      "loserUuid": "499a829d-e18d-4b3a-81a8-7aad418fef95",
      "firstTo": [
        {
          "teamId": "da067403-25e8-4f40-a02e-55cda46f0b6b",
          "teamName": "Kansas City Chiefs",
          "value": 0.695565,
          "title": "firstFieldGoal"
        },
        {
          "teamId": "da067403-25e8-4f40-a02e-55cda46f0b6b",
          "teamName": "Kansas City Chiefs",
          "value": 0.813783,
          "title": "firstInterception"
        },
        {
          "teamId": "da067403-25e8-4f40-a02e-55cda46f0b6b",
          "teamName": "Kansas City Chiefs",
          "value": 0.500814,
          "title": "firstPenalty"
        },
        {
          "teamId": "da067403-25e8-4f40-a02e-55cda46f0b6b",
          "teamName": "Kansas City Chiefs",
          "value": 0.728931,
          "title": "firstSack"
        },
        {
          "teamId": "da067403-25e8-4f40-a02e-55cda46f0b6b",
          "teamName": "Kansas City Chiefs",
          "value": 0.687686,
          "title": "firstTouchdown"
        }
      ]
    },
    "relationships": {
      "event": {
        "data": {
          "type": "Event",
          "id": "\/american-football\/v2\/events\/d2554158-f1fe-4fa2-97b5-bf7f076979d4"
        }
      }
    }
  }
}

Or you can request the winLoss relationship to be included in the original events request:

GET https://api.quarter4.io/american-football/v2/events?startDate[after]=now&order[startDate]=asc&league.uuid=38344248-9889-11eb-a8ab-0647cdb505d0&page=1&count=30&include=winLoss

For example:

{
  "links": {
    "self": "\/american-football\/v2\/events?count=1\u0026include=winloss\u0026league.uuid=38344248-9889-11eb-a8ab-0647cdb505d0\u0026order%5BstartDate%5D=asc\u0026startDate%5Bafter%5D=now\u0026page=1",
    "first": "\/american-football\/v2\/events?count=1\u0026include=winloss\u0026league.uuid=38344248-9889-11eb-a8ab-0647cdb505d0\u0026order%5BstartDate%5D=asc\u0026startDate%5Bafter%5D=now\u0026page=1",
    "last": "\/american-football\/v2\/events?count=1\u0026include=winloss\u0026league.uuid=38344248-9889-11eb-a8ab-0647cdb505d0\u0026order%5BstartDate%5D=asc\u0026startDate%5Bafter%5D=now\u0026page=256",
    "next": "\/american-football\/v2\/events?count=1\u0026include=winloss\u0026league.uuid=38344248-9889-11eb-a8ab-0647cdb505d0\u0026order%5BstartDate%5D=asc\u0026startDate%5Bafter%5D=now\u0026page=2"
  },
  "meta": {
    "totalItems": 256,
    "itemsPerPage": 1,
    "currentPage": 1
  },
  "data": [
    {
      "id": "\/american-football\/v2\/events\/d2554158-f1fe-4fa2-97b5-bf7f076979d4",
      "type": "Event",
      "attributes": {
        "startDate": "2022-09-16T00:15:00+00:00",
        "eventStatus": {
          "name": "pre-game",
          "uuid": "9e840b68-5855-4f46-a7b9-7e97694258fc"
        },
        "homeTeamScore": null,
        "awayTeamScore": null,
        "title": "Los Angeles Chargers at Kansas City Chiefs",
        "homeSeed": null,
        "awaySeed": null,
        "coverage": "full",
        "otherBooksData": {
          "spread_home": {
            "MGM": "-3.5",
            "DraftKings": "-3.5",
            "FanDuel": "-3.5",
            "Westgate": "-3.5",
            "SugarHouseNJ": "-3.5",
            "PointsBet": "-3.5",
            "Bet365NewJersey": "-3.5"
          },
          "spread_away": {
            "MGM": "3.5",
            "DraftKings": "3.5",
            "FanDuel": "3.5",
            "Westgate": "3.5",
            "SugarHouseNJ": "3.5",
            "PointsBet": "3.5",
            "Bet365NewJersey": "3.5"
          },
          "over_under": {
            "MGM": "54.5",
            "DraftKings": "54.5",
            "FanDuel": "54.5",
            "Westgate": "54",
            "SugarHouseNJ": "54.5",
            "PointsBet": "54.5",
            "Bet365NewJersey": "54.5"
          }
        },
        "uuid": "d2554158-f1fe-4fa2-97b5-bf7f076979d4",
        "awayRemainingTimeouts": null,
        "clock": null,
        "displayStatus": "scheduled"
      },
      "relationships": {
        "league": {
          "data": {
            "type": "League",
            "id": "\/american-football\/v2\/leagues\/38344248-9889-11eb-a8ab-0647cdb505d0"
          }
        },
        "homeTeam": {
          "data": {
            "type": "Team",
            "id": "\/american-football\/v2\/teams\/da067403-25e8-4f40-a02e-55cda46f0b6b"
          }
        },
        "awayTeam": {
          "data": {
            "type": "Team",
            "id": "\/american-football\/v2\/teams\/499a829d-e18d-4b3a-81a8-7aad418fef95"
          }
        },
        "winloss": {
          "data": {
            "type": "WinLoss",
            "id": "\/american-football\/v2\/win_losses\/d2554158-f1fe-4fa2-97b5-bf7f076979d4"
          }
        }
      }
    }
  ],
  "included": [
    {
      "id": "\/american-football\/v2\/win_losses\/d2554158-f1fe-4fa2-97b5-bf7f076979d4",
      "type": "WinLoss",
      "attributes": {
        "uuid": "d2554158-f1fe-4fa2-97b5-bf7f076979d4",
        "detail": "The Kansas City Chiefs have a 53.9% chance of beating the Los Angeles Chargers",
        "homeWinProbability": 54,
        "awayWinProbability": 46,
        "homeSpread": -1,
        "awaySpread": 1,
        "overUnder": 55.9742,
        "winLossSpreadConsistency": 1,
        "otherBooksData": {
          "spread_home": {
            "MGM": "-3.5",
            "DraftKings": "-3.5",
            "FanDuel": "-3.5",
            "Westgate": "-3.5",
            "SugarHouseNJ": "-3.5",
            "PointsBet": "-3.5",
            "Bet365NewJersey": "-3.5"
          },
          "spread_away": {
            "MGM": "3.5",
            "DraftKings": "3.5",
            "FanDuel": "3.5",
            "Westgate": "3.5",
            "SugarHouseNJ": "3.5",
            "PointsBet": "3.5",
            "Bet365NewJersey": "3.5"
          },
          "over_under": {
            "MGM": "54.5",
            "DraftKings": "54.5",
            "FanDuel": "54.5",
            "Westgate": "54",
            "SugarHouseNJ": "54.5",
            "PointsBet": "54.5",
            "Bet365NewJersey": "54.5"
          }
        },
        "overtimeProbability": 0.13286,
        "predictAsOvertime": 0,
        "homeFirstFieldGoal": 0.695565,
        "awayFirstFieldGoal": 0.304435,
        "homeFirstInterception": 0.813783,
        "awayFirstInterception": 0.186217,
        "homeFirstPenalty": 0.500814,
        "awayFirstPenalty": 0.499186,
        "homeFirstSack": 0.728931,
        "awayFirstSack": 0.271069,
        "homeFirstTouchdown": 0.687686,
        "awayFirstTouchdown": 0.312314,
        "probability": 54,
        "winnerUuid": "da067403-25e8-4f40-a02e-55cda46f0b6b",
        "loserUuid": "499a829d-e18d-4b3a-81a8-7aad418fef95",
        "firstTo": [
          {
            "teamId": "da067403-25e8-4f40-a02e-55cda46f0b6b",
            "teamName": "Kansas City Chiefs",
            "value": 0.695565,
            "title": "firstFieldGoal"
          },
          {
            "teamId": "da067403-25e8-4f40-a02e-55cda46f0b6b",
            "teamName": "Kansas City Chiefs",
            "value": 0.813783,
            "title": "firstInterception"
          },
          {
            "teamId": "da067403-25e8-4f40-a02e-55cda46f0b6b",
            "teamName": "Kansas City Chiefs",
            "value": 0.500814,
            "title": "firstPenalty"
          },
          {
            "teamId": "da067403-25e8-4f40-a02e-55cda46f0b6b",
            "teamName": "Kansas City Chiefs",
            "value": 0.728931,
            "title": "firstSack"
          },
          {
            "teamId": "da067403-25e8-4f40-a02e-55cda46f0b6b",
            "teamName": "Kansas City Chiefs",
            "value": 0.687686,
            "title": "firstTouchdown"
          }
        ]
      },
      "relationships": {
        "event": {
          "data": {
            "type": "Event",
            "id": "\/american-football\/v2\/events\/d2554158-f1fe-4fa2-97b5-bf7f076979d4"
          }
        }
      }
    }
  ]
}

The resulting win_loss Entity gives you the win percentages, over under, spread, as well as additional pre-game probabilities depending on the league and sport.