Skip to content
datasportsAPI

FixturesSource win probability

Documentation

/

Type to filter the docs by title or path.

FixturesEndpoint 15 of 116

Source win probability

GET

/v2/fixtures/{id}/win-probability/source

Plan
Pro + Business
Auth
Bearer dsa_live_…
Parameters
1 required · 0 optional
Returns
SourceWinProbability
Try in Playground

In-game win probability as published by our data source (not DataSportsAPI’s model): home and away values for each minute of play. Limited to American football (NFL), the only sport for which the source provides it. Available on Pro and Business plans.

Plan access

Requires a Pro or Business plan; every other plan receives 403 endpoint_not_in_plan.

Worth knowing

  • The model field always reads "source": the figure comes with the source’s match data, and we do not know how it is calculated.
  • For our own model see /v2/fixtures/{id}/win-probability (football only, models v1 to v3).
  • Treat it as an analytical indicator, not betting advice.
  • minute counts playing time (15 per NFL quarter, with overtime continuing the sequence), at roughly one point per minute; individual minutes may be absent and the curve may begin at 1.
  • The last point is just the source’s final estimate; it is not forced to 1 / 0 when the game ends.
  • Ties are not modelled, so home + away = 1.
  • Any other sport, or a game without source data, returns 200 with an empty series and the period figures set to null.
  • There is no WebSocket frame for it; over REST, polling about every 30 seconds during play is enough.

01Parameters

  • idpathRequired

    fixture id issued by DataSportsAPI, a positive integer

02Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

curl -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/fixtures/{id}/win-probability/source"

03Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

data
SourceWinProbability
meta
count (number of points in series)
ObjectsSourceWinProbability
Example response
{ "data": { "fixtureId": 218455, "model": "source", "periodLengthMinutes": 15, "periodCount": 4, "overtimeLengthMinutes": 10,
    "series": [ { "minute": 1, "home": 0.63, "away": 0.37 }, { "minute": 2, "home": 0.65, "away": 0.35 }, …,
      { "minute": 48, "home": 0.99, "away": 0.01 } ] },
  "meta": { "count": 48 } }

04Errors

  • 403endpoint_not_in_plan

    returned to keys on the Free and Starter plans

  • 403history_not_in_plan

    the fixture predates the history your plan covers

  • 404not_found

    no fixture exists with that id

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code