# GET /v2/odds

Group: Betting odds

The main market — the three-way result where the sport has draws, else the winner — of every fixture of a sport the bookmaker prices on a day. One call for a whole odds list. Pro, Business and Enterprise plans.

Plans: Pro and up (other plans get 403 endpoint_not_in_plan).

Note: The bookmaker’s own day list: it can reach a few hours either side of the UTC day — read each fixture’s startTime from /v2/fixtures/{id} (or your day list) to place it. Refreshed every few minutes; every market of one fixture: /v2/fixtures/{id}/odds.

## Parameters

| Name | In | Required | Description |
| --- | --- | --- | --- |
| `sport` | query | yes | a sport slug (/v2/sports) |
| `date` | query | no | YYYY-MM-DD (default today, UTC) |

## Response

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

## Errors

- 400 bad_request — sport missing or unknown, date malformed
- 403 endpoint_not_in_plan — Free and Starter keys
- 403 history_not_in_plan — a day before your plan’s history

Plus the common errors (https://sportsapi.app/markdown/en/docs.md#errors).

## Request

cURL:

```bash
curl -H "Authorization: Bearer sk_live_…" \
    "https://api.sportsapi.app/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, &sportsapi.OddsListParams{Sport: sport})
```

CLI:

```bash
$ sportsapi 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.sportsapi.app. Send your API key as `Authorization: Bearer <key>` on every /v2 request; keys are created in the dashboard (https://sportsapi.app/dashboard).
HTML: https://sportsapi.app/docs/odds/list · All docs: https://sportsapi.app/markdown/en/docs.md