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

Group: Betting odds

All markets the bookmaker offers on a fixture — result (1X2), double chance, draw no bet, winner, first to score, both teams to score, Asian handicap, handicap / point spread, goal / card / corner / points totals, the cricket toss winner, most sixes, a hundred / fifty in the match, and next goal (live). Each comes with opening and current prices in decimal and fractional form, the direction of the latest price change, its suspension state and, once the match is over, the winning selections. 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: Every market has a key that stays the same for the whole fixture, built from the kind followed by :period, :line and :live ("result", "result:half1", "totalGoals:2.5", "asianHandicap:-1.25", "winner:live"); use it to merge WebSocket odds frames. During play the bookmaker shows the in-play market (live: true, key ending …:live) alongside the now-closed pre-match market, which keeps its final prices from before kick-off. line is the figure of a total or the handicap of the HOME side; when the line moves, the market gets a new key. decimal equals 1 + fractional, rounded to 2 decimal places. winning is null until settlement and wherever nobody settles the market, and settledBy tells you who set it. The source leaves some markets unsettled: on NBA games the point spread (handicap) and the first-quarter winner were still null hours after full time when we checked on 2026-11-05, and so were football Asian handicaps and total cards on every finished fixture days later (checked 2026-11-12), while results, winners and goal totals came within minutes (settledBy "source"). Since 2026-11-12 we settle two of those from the final result ourselves, marked settledBy "computed" and never overriding a flag the source has set: football Asian handicaps on half lines, from the regular-time score, and football total cards on half lines when the match saw yellow cards only, all shown to players on the pitch and with the incidents and statistics in agreement. Any other market the source leaves open stays null permanently. A bet is decided by the bookmaker’s own rules. An empty markets list, with updatedAt null, means the bookmaker offers nothing on the fixture — typical for minor leagues and matches far in the future. Over REST the data refreshes roughly every 30 seconds in play; subscribe to odds:{id} to receive every price change.

## Parameters

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

## Response

- `data`: `Odds`
- `meta`: count (number of markets)
- Objects: Odds (https://datasportsapi.com/markdown/reference.md#odds)

## 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"
```

TypeScript:

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

Python:

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

Go:

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

CLI:

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

## Example response

```json
{ "data": { "fixtureId": 701210, "updatedAt": "2026-11-04T17:20:00.000Z",
    "markets": [
      { "key": "result", "kind": "result", "name": "Full time", "period": "match", "line": null, "live": false, "suspended": false,
        "choices": [
          { "name": "1", "outcome": "home", "fractional": "19/20", "decimal": 1.95, "openingFractional": "11/10", "openingDecimal": 2.1, "change": "down", "winning": null },
          { "name": "X", "outcome": "draw", "fractional": "10/3", "decimal": 4.33, "openingFractional": "5/2", "openingDecimal": 3.5, "change": "up", "winning": null },
          { "name": "2", "outcome": "away", "fractional": "11/5", "decimal": 3.2, "openingFractional": "11/5", "openingDecimal": 3.2, "change": "none", "winning": null } ], "settledBy": null },
      { "key": "totalGoals:2.5", "kind": "totalGoals", "name": "Match goals", "period": "match", "line": 2.5, "live": false, "suspended": false,
        "choices": [ { "name": "Over", "outcome": "over", "fractional": "4/5", "decimal": 1.8, … }, { "name": "Under", "outcome": "under", … } ] },
      { "key": "asianHandicap:-0.5", "kind": "asianHandicap", "name": "Asian handicap", "period": "match", "line": -0.5, … }, … ] },
  "meta": { "count": 19 } }
```

---

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