# GET /v2/fixtures/{id}/momentum

Group: Fixtures

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.

Plans: Requires Pro, Business or Enterprise; a Free or Starter key receives 403 endpoint_not_in_plan.

Note: 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

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `id` | path | yes | fixture id issued by DataSportsAPI, a positive integer |

## Response

- `data`: `Momentum`
- Objects: Momentum (https://datasportsapi.com/markdown/reference.md#momentum)

## Errors

Plus the common errors (https://datasportsapi.com/markdown/docs.md#errors).

## Request

cURL:

```bash
curl -H "Authorization: Bearer sk_live_…" \
    "https://api.datasportsapi.com/v2/fixtures/{id}/momentum"
```

TypeScript:

```ts
const { data, meta } = await client.fixtures.momentum(id);
```

Python:

```python
res = client.fixtures.momentum(id)
```

Go:

```go
res, err := client.Fixtures.Momentum(ctx, id)
```

CLI:

```bash
$ dsa fixtures momentum <id>
```

## Example response

```json
{ "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 }, … ] } }
```

---

Base URL: https://api.datasportsapi.com. Authenticate each /v2 call with the header `Authorization: Bearer <key>` (secret keys begin with `sk_live_`).
HTML: https://datasportsapi.com/docs/fixtures/momentum/ · All docs: https://datasportsapi.com/markdown/docs.md · Data reference: https://datasportsapi.com/markdown/reference.md
