# GET /v2/odds

Group: Betting odds

Returns the headline market for every fixture of a sport that the bookmaker prices on a given day — the three-way result in sports with draws, otherwise the winner. A complete odds list in a single request. 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: The day follows the bookmaker’s own list, which may stretch a few hours before or after the UTC day; to place a fixture correctly, take its startTime from /v2/fixtures/{id} or from your own day listing. Updated every few minutes. For all markets on one fixture, call /v2/fixtures/{id}/odds.

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `sport` | query | yes | sport slug, as listed by /v2/sports |
| `date` | query | no | date as YYYY-MM-DD; defaults to the current UTC day |

## Response

- `data`: `FeaturedOdds[]`
- `meta`: count, date, sport
- Objects: FeaturedOdds (https://datasportsapi.com/markdown/reference.md#featuredodds)

## Errors

- 400 bad_request — sport is missing or not recognised, or the date is not in YYYY-MM-DD form
- 403 endpoint_not_in_plan — returned to keys on the Free and Starter plans
- 403 history_not_in_plan — your plan’s history does not reach back to that date

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/odds?sport=…"
```

TypeScript:

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

Python:

```python
res = client.odds.list(sport=sport)
```

Go:

```go
res, err := client.Odds.List(ctx, &datasportsapi.OddsListParams{Sport: sport})
```

CLI:

```bash
$ dsa odds list <sport>
```

## Example response

```json
{ "data": [ { "fixtureId": 701210, "market": { "key": "result", "kind": "result", "name": "Full time", "period": "match", "line": null,
      "live": false, "suspended": false, "choices": [ { "name": "1", "outcome": "home", "fractional": "23/10", "decimal": 3.3, … }, … ], "settledBy": null } }, … ],
  "meta": { "count": 450, "date": "2026-11-04", "sport": "football" } }
```

---

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