# RapidAPI · live-sports-odds (theoddsapi)

Gateway provider `rapidapi-live-sports-odds` · call `https://fetchapi.co/api/gw/rapidapi-live-sports-odds/<path>` with header `x-api-key` (get a key at https://fetchapi.co/keys) · MCP: tools `search_endpoints`, `get_endpoint`, `call_endpoint` at https://fetchapi.co/api/mcp · listing: https://rapidapi.com/theoddsapi/api/live-sports-odds/pricing

Upstream plan: PRO: $30/month for 20,000 requests; free tier: BASIC: 500 requests/month, hard limit, 5 req/s (https://rapidapi.com/theoddsapi/api/live-sports-odds/pricing).

3 working endpoints, each tested live through this gateway. Endpoints that returned no data in our latest test, write actions and endpoints that need the end user's own login are not listed.

## `rapidapi-live-sports-odds.v4_sports` — /v4/sports

`GET /v4/sports` · ✓ working (tested 2026-11-02) · sampled 2026-10-22, 69 ms

Every sport and league The Odds API covers, one row each: the key to pass to the odds and scores calls (e.g. americanfootball_nfl), its group, title, whether it is in season (active) and whether it has outright (futures) markets. Without all=true only in-season sports are listed. On RapidAPI this call counts as 1 request.

| param | required | example / default |
|---|---|---|
| `all` | no | true |

Fields: `[].key` the sport key used by the odds and scores calls; `[].active` in season now; `[].has_outrights` the sport has futures / outright winner markets

```bash
curl "https://fetchapi.co/api/gw/rapidapi-live-sports-odds/v4/sports?all=true" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
[
 {
  "key": "americanfootball_cfl",
  "group": "American Football",
  "title": "CFL",
  "active": true,
  "description": "Canadian Football League",
  "has_outrights": false
 },
 {
  "key": "americanfootball_ncaaf",
  "group": "American Football",
  "title": "NCAAF",
  "active": true,
  "description": "US College Football",
  "has_outrights": false
 },
 {
  "key": "americanfootball_ncaaf_championship_winner",
  "group": "American Football",
  "title": "NCAAF Championship Winner",
  "active": true,
  "description": "US College Football Championship Winner",
  "has_outrights": true
 },
 "… 178 more"
]
```

## `rapidapi-live-sports-odds.v4_sports_sport_odds` — /v4/sports/{sport}/odds

`GET /v4/sports/{sport}/odds` · ✓ working (tested 2026-11-01) · sampled 2026-10-22, 80 ms

Upcoming and live games of one sport, each with its home and away team, start time and every bookmaker's current odds for the markets asked for (h2h moneyline, spreads, totals; outrights for futures). Each market x region counts as 1 RapidAPI request (h2h in us = 1; h2h,spreads in us,uk = 4); naming bookmakers instead of regions counts 1 per market.

| param | required | example / default |
|---|---|---|
| `sport` | yes | americanfootball_nfl |
| `regions` | yes | us |
| `oddsFormat` | no | american |
| `markets` | no | h2h |
| `dateFormat` | no | iso |

Fields: `[].bookmakers[].markets[].outcomes[].price` the odds, in the oddsFormat asked for (decimal or american); `[].bookmakers[].markets[].outcomes[].point` the handicap (spreads) or total line (totals); `[].commence_time` game start time, ISO 8601 UTC

```bash
curl "https://fetchapi.co/api/gw/rapidapi-live-sports-odds/v4/sports/americanfootball_nfl/odds?markets=h2h&regions=us&dateFormat=iso&oddsFormat=american" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
[
 {
  "id": "ffebea881c1d7b2dfb85b3e590c35985",
  "away_team": "New England Patriots",
  "home_team": "Chicago Bears",
  "sport_key": "americanfootball_nfl",
  "bookmakers": [
   {
    "key": "draftkings",
    "title": "DraftKings",
    "markets": [
     {
      "key": "h2h",
      "outcomes": [
       {
        "name": "Chicago Bears",
        "price": -155
       },
       {
        "name": "New England Patriots",
        "price": 130
       }
      ],
      "last_update": "2026-10-22T17:56:33Z"
     }
    ],
    "last_update": "2026-10-22T17:56:33Z"
   },
   {
    "key": "williamhill_us",
    "title": "Caesars",
    "markets": [
     {
      "key": "h2h",
      "outcomes": [
       {
        "name": "Chicago Bears",
        "price": -162
       },
       {
        "name": "New England Patriots",
        "price": 136
       }
      ],
      "last_update": "2026-10-22T17:56:34Z"
     }
    ],
    "last_update": "2026-10-22T17:56:35Z"
   },
   {
    "key": "fanduel",
    "title": "FanDuel",
    "markets": [
     {
      "key": "h2h",
      "outcomes": [
       {
        "name": "Chicago Bears",
        "price": -158
       },
       {
        "name": "New England Patriots",
        "price": 134
       }
      ],
      "last_update": "2026-10-22T17:56:34Z"
     }
    ],
    "last_update": "2026-10-22T17:56:34Z"
   },
   "… 8 more"
  ],
  "sport_title": "NFL",
  "commence_time": "2026-10-23T00:15:00Z"
 },
 {
  "id": "2e710ea5a306b614f0f966e3d78732f8",
  "away_team": "Pittsburg
…
```

## `rapidapi-live-sports-odds.v4_sports_sport_scores` — /v4/sports/{sport}/scores

`GET /v4/sports/{sport}/scores` · ✓ working (tested 2026-11-02) · sampled 2026-10-22, 56 ms

Live, upcoming and recently finished games of one sport with their scores (null before kick-off), whether each is completed, and when the score last changed. daysFrom (1-3) adds games completed in the last N days and makes the call count as 2 RapidAPI requests instead of 1.

| param | required | example / default |
|---|---|---|
| `sport` | yes | americanfootball_nfl |
| `daysFrom` | no | 1 |

Fields: `[].scores` [{name, score}] per team; null until the game starts; `[].completed` the game is over

```bash
curl "https://fetchapi.co/api/gw/rapidapi-live-sports-odds/v4/sports/americanfootball_nfl/scores?daysFrom=1" \
  -H "x-api-key: $FETCHAPI_KEY"
```

Real answer (trimmed):

```json
[
 {
  "id": "ffebea881c1d7b2dfb85b3e590c35985",
  "scores": null,
  "away_team": "New England Patriots",
  "completed": false,
  "home_team": "Chicago Bears",
  "sport_key": "americanfootball_nfl",
  "last_update": null,
  "sport_title": "NFL",
  "commence_time": "2026-10-23T00:15:00Z"
 },
 {
  "id": "2e710ea5a306b614f0f966e3d78732f8",
  "scores": null,
  "away_team": "Pittsburgh Steelers",
  "completed": false,
  "home_team": "New Orleans Saints",
  "sport_key": "americanfootball_nfl",
  "last_update": null,
  "sport_title": "NFL",
  "commence_time": "2026-10-25T13:30:00Z"
 },
 {
  "id": "b1be064fb52a198a62109c279e7ab24c",
  "scores": null,
  "away_team": "San Francisco 49ers",
  "completed": false,
  "home_team": "Atlanta Falcons",
  "sport_key": "americanfootball_nfl",
  "last_update": null,
  "sport_title": "NFL",
  "commence_time": "2026-10-25T17:00:00Z"
 },
 "… 25 more"
]
```
