Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Fixtures

Momentum

GET

/v2/fixtures/{id}/momentum

Pro and up

View as MarkdownTry in Playground →

Attack-momentum curve (football, plus any other sport where the source draws one) with a point for every minute: positive values mean home pressure, negative values away pressure. Tennis uses games instead — a value per game (positive when the home player took it) plus a flag for whether serve was broken.

points is filled for football, basketball and ice hockey in covered leagues; games is filled for tennis only (where points stays empty) and is empty for all other sports. Both lists are empty before kick-off and when no graph exists. Football gives each added-time minute its own point: minute stays at the last minute of the period (45 or 90) and addedMinute runs 1, 2, …; in normal time addedMinute is null. In other sports (basketball, handball, …) a minute value ending in .5 can mark the end of a period — 45.5 is half-time. Football and ice hockey have used the curve the source draws on its own website since 2026-11-04 (see the changelog).

Parameters

id

pathrequired

fixture id issued by DataSportsAPI, a positive integer

Response

Any /v2 call can also come back with one of the common errors.

curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/fixtures/{id}/momentum"
Example
{ "data": { "points": [ { "minute": 1, "addedMinute": null, "value": 3 }, { "minute": 2, "addedMinute": null, "value": 12 }, …,
                       { "minute": 45, "addedMinute": null, "value": 0 }, { "minute": 45, "addedMinute": 1, "value": -22 }, …, { "minute": 46, "addedMinute": null, "value": 16 }, … ],
    "periodLengthMinutes": 45, "periodCount": 2, "overtimeLengthMinutes": 15, "overtimeCount": null, "games": [] } }

// Tennis:
{ "data": { "points": [], "periodLengthMinutes": null, "periodCount": null, "overtimeLengthMinutes": null, "overtimeCount": null,
    "games": [ { "period": "period1", "game": 1, "value": -10, "breakOfServe": false },
               { "period": "period1", "game": 2, "value": 34, "breakOfServe": true }, … ] } }