> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sportsapipro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Match Odds

> Multi-bookmaker odds — EU (1X2), Asian handicap, Over/Under with opening & closing lines

## Get All Odds

```text theme={null}
GET /api/v1/match/{matchId}/odds
```

<CodeGroup>
  ```bash New canonical theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    "https://api.sportsapipro.com/v6/football/match/ezk96i3gzz5a1kn/odds"
  ```

  ```bash Classic theme={null}
  curl -H "x-api-key: YOUR_API_KEY" \
    "https://api.sportsapipro.com/v6/football/match/ezk96i3gzz5a1kn/odds"
  ```
</CodeGroup>

### Response

```json theme={null}
{
  "success": true,
  "eu":   [{ "f": { "odd": ["11", "6.5", "1.2", "0"] }, "s": { "odd": ["21", "9", "1.11", "0"] }, "company": { "id": 2 } }],
  "asia": [{ "f": { "odd": ["1.05", "-1.75", "0.8", "0"] }, "s": { "odd": ["1.1", "-2", "0.7", "0"] } }],
  "bs":   [{ "f": { "odd": ["0.97", "3", "0.87", "0"] }, "s": { "odd": ["0.7", "2.75", "1.1", "0"] } }],
  "companies": [
    { "id": 2,   "name": "bet365",   "logo": "fe8aec51afeb2de633c9.png" },
    { "id": 101, "name": "1xbet",    "logo": "..." },
    { "id": 3,   "name": "CrownBet", "logo": "..." }
  ]
}
```

### Odds shape

| Bucket | Meaning                  | `odd` array                         |
| ------ | ------------------------ | ----------------------------------- |
| `eu`   | European / 1X2           | `[home, draw, away, 0]`             |
| `asia` | Asian handicap           | `[homeOdds, handicap, awayOdds, 0]` |
| `bs`   | Over / Under (Big-Small) | `[overOdds, total, underOdds, 0]`   |

Each entry has both **`f`** (opening line) and **`s`** (current/closing line) plus a `company` reference. Match the `company.id` against the `companies[]` array for bookmaker name and logo.

## Get Odds by Bookmaker

```text theme={null}
GET /api/v1/match/{matchId}/odds/{companyId}?type=1
```

| Parameter   | Required | Description                       |
| ----------- | -------- | --------------------------------- |
| `companyId` | yes      | Bookmaker ID (e.g. `2` = bet365)  |
| `type`      | no       | `1` = EU · `2` = Asian · `3` = BS |

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.sportsapipro.com/v6/football/match/ezk96i3gzz5a1kn/odds/2?type=1"
```

**Cache TTL:** 30 s for both endpoints.