# GET /v2/fixtures/{id}/odds/winning

Group: Betting odds

Winning odds set each side’s win price against the probability it implies and how often sides priced that way have really won: the source’s figures, showing at a glance if the market under- or overrates a side. Available on Pro, Business and Enterprise plans.

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

Note: expectedWinPercentage is the probability implied by the price — roughly 100 / decimal, rounded, with the bookmaker’s margin still included. actualWinPercentage is the share of sides at that price that went on to win, according to our data source, which does not disclose the sample or the time span behind it. Which pre-match price is used is the source’s choice, and it can match none of the opening or current prices in /v2/fixtures/{id}/odds. Only the two sides are compared, so no draw entry exists. Where the source lacks figures for a side, that side is null (sometimes only one side is covered); for fixtures the source does not cover at all — most minor leagues, doubles, matches far in the future — both sides and updatedAt are null. Refreshed at the same rate as the odds: about every 30 seconds in play.

## Parameters

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

## Response

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

## Errors

- 403 endpoint_not_in_plan — returned to keys on the Free and Starter plans
- 403 history_not_in_plan — the fixture predates the history your plan covers
- 404 not_found — DataSportsAPI never issued this id

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}/odds/winning"
```

TypeScript:

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

Python:

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

Go:

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

CLI:

```bash
$ dsa fixtures winning-odds <id>
```

## Example response

```json
{ "data": { "fixtureId": 701230, "updatedAt": "2026-11-06T01:20:00.000Z",
    "home": { "fractional": "33/20", "decimal": 2.65, "expectedWinPercentage": 38, "actualWinPercentage": 38 },
    "away": { "fractional": "157/100", "decimal": 2.57, "expectedWinPercentage": 39, "actualWinPercentage": 47 } } }
```

---

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/odds/fixtures-winning-odds/ · All docs: https://datasportsapi.com/markdown/docs.md · Data reference: https://datasportsapi.com/markdown/reference.md
