The Odds API V4

https://the-odds-api.com/liveapi/guides/v4/
Admin
The Odds API V4 provides real-time and historical sports odds, scores, and event data from various...
Tokens:27,947
Snippets:166
Trust Score:5.1
Update:1 month ago
Show doc for...
Tokens:
Raw
### Example GET Request for Participants

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

Use this GET request to retrieve a list of participants for a specific sport. Replace YOUR_API_KEY with your actual API key.

```bash
GET https://api.the-odds-api.com/v4/sports/americanfootball_nfl/participants?apiKey=YOUR_API_KEY
```

--------------------------------

### Example GET Request for Event Markets

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

This example demonstrates how to construct a GET request to retrieve market keys for a baseball (MLB) event. Ensure you replace 'YOUR_API_KEY' with your actual API key and specify the desired regions.

```bash
GET https://api.the-odds-api.com/v4/sports/baseball_mlb/events/19699ba901294e39cb07fc4f19929a38/markets?apiKey=YOUR_API_KEY&regions=us
```

--------------------------------

### GET Scores Request Example

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

This example demonstrates how to make a GET request to the scores endpoint for NBA games from the past day. Replace YOUR_API_KEY with your actual API key.

```http
GET https://api.the-odds-api.com/v4/sports/basketball_nba/scores/?daysFrom=1&apiKey=YOUR_API_KEY
```

--------------------------------

### Example: 3 Markets, 3 Regions Cost

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

Provides an example of an API request and its calculated cost for multiple markets and regions.

```text
/v4/historical/sports/basketball_nba/events/0b83beff5f82f8623eea93dbc1d7cd4e/odds?markets=player_points,player_assists,alternate_spreads&regions=us,us2,au&...
```

--------------------------------

### Example API Request URL for 1 Market, 3 Regions

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

Demonstrates an example API request URL for Soccer (EPL) with one market (h2h) and three regions (us, uk, eu).

```text
/v4/sports/soccer_epl/odds?markets=h2h&regions=us,uk,eu&...
```

--------------------------------

### Example API Request URL for 1 Market, 1 Region

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

Demonstrates an example API request URL for American Football (NFL) with one market (h2h) and one region (us).

```text
/v4/sports/americanfootball_nfl/odds?markets=h2h&regions=us&...
```

--------------------------------

### Example API Request URL for 3 Markets, 3 Regions

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

Demonstrates an example API request URL for Basketball (NBA) with three markets (h2h, spreads, totals) and three regions (us, uk, au).

```text
/v4/sports/basketball_nba/odds?markets=h2h,spreads,totals&regions=us,uk,au&...
```

--------------------------------

### Example Request for Event Odds

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

This is an example of a GET request to retrieve player passing touchdown odds for a specific NFL game. Ensure you replace YOUR_API_KEY with your actual API key.

```bash
GET https://api.the-odds-api.com/v4/sports/americanfootball_nfl/events/a512a48a58c4329048174217b2cc7ce0/odds?apiKey=YOUR_API_KEY&regions=us&markets=player_pass_tds&oddsFormat=american
```

--------------------------------

### Example API Request URL for 3 Markets, 1 Region

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

Demonstrates an example API request URL for American Football (NFL) with three markets (h2h, spreads, totals) and one region (us).

```text
/v4/sports/americanfootball_nfl/odds?markets=h2h,spreads,totals&regions=us&...
```

--------------------------------

### GET Historical NFL Odds Example

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

This example demonstrates how to request historical odds for NFL games on a specific date and market. Ensure you replace 'YOUR_API_KEY' with your actual API key.

```bash
GET https://api.the-odds-api.com/v4/historical/sports/americanfootball_nfl/odds/?apiKey=YOUR_API_KEY&regions=us&markets=h2h&oddsFormat=american&date=2021-10-18T12:00:00Z
```

--------------------------------

### Example: 1 Market, 1 Region Cost

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

Demonstrates the API request and calculated cost for a single market and region.

```text
/v4/historical/sports/americanfootball_nfl/events/a512a48a58c4329048174217b2cc7ce0/odds?markets=player_pass_tds&regions=us&...
```

--------------------------------

### GET Events Request Example

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

Use this endpoint to retrieve a list of events for a specific sport. Ensure you replace YOUR_API_KEY with your actual API key.

```http
GET https://api.the-odds-api.com/v4/sports/americanfootball_nfl/events?apiKey=YOUR_API_KEY
```

--------------------------------

### Example: 1 Market, 3 Regions Cost

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

Shows the API request and calculated cost for a single market across multiple regions.

```text
/v4/historical/sports/basketball_nba/events/037d7b6bb128546961e2a06680f63944/odds?markets=player_points&regions=us,us2,au&...
```

--------------------------------

### Get NFL Odds with American Format

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

Example request to fetch NFL odds for US regions, including head-to-head and spreads markets, formatted in American odds. Ensure to replace YOUR_API_KEY with your actual API key.

```bash
GET https://api.the-odds-api.com/v4/sports/americanfootball_nfl/odds/?apiKey=YOUR_API_KEY&regions=us&markets=h2h,spreads&oddsFormat=american
```

--------------------------------

### GET Historical NBA Events

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

Fetches historical NBA events for a specific date. This example demonstrates a basic request to the historical events endpoint.

```bash
GET https://api.the-odds-api.com/v4/historical/sports/basketball_nba/events?apiKey=YOUR_API_KEY&date=2023-11-29T22:42:00Z
```

--------------------------------

### Example API Request for 1 Market, 3 Regions

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

Shows an API call for one market across three different regions, resulting in a quota cost of 3.

```text
/v4/sports/soccer_epl/events/037d7b6bb128546961e2a06680f63944/odds?markets=h2h&regions=us,uk,eu&...
```

--------------------------------

### Example Scores Response

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

This is an example of the JSON response structure for the scores endpoint, showing details for completed NBA games. The 'scores' array contains team names and their respective scores.

```json
[
    {
        "id": "572d984e132eddaac3da93e5db332e7e",
        "sport_key": "basketball_nba",
        "sport_title": "NBA",
        "commence_time": "2022-02-06T03:10:38Z",
        "completed": true,
        "home_team": "Sacramento Kings",
        "away_team": "Oklahoma City Thunder",
        "scores": [
            {
                "name": "Sacramento Kings",
                "score": "113"
            },
            {
                "name": "Oklahoma City Thunder",
                "score": "103"
            }
        ],
        "last_update": "2022-02-06T05:18:19Z"
    },
    {
        "id": "e2296d6d1206f8d185466876e2b444ea",
        "sport_key": "basketball_nba",
        "sport_title": "NBA",
        "commence_time": "2022-02-06T03:11:26Z",
        "completed": true,
        "home_team": "Portland Trail Blazers",
        "away_team": "Milwaukee Bucks",
        "scores": [
            {
                "name": "Portland Trail Blazers",
                "score": "108"
            },
            {
                "name": "Milwaukee Bucks",
                "score": "137"
            }
        ],
        "last_update": "2022-02-06T05:21:01Z"
    },
    {
        "id": "8d8affc2e29bcafd3cdec8b414256cda",
        "sport_key": "basketball_nba",
        "sport_title": "NBA",
        "commence_time": "2022-02-06T20:41:04Z",
        "completed": true,
        "home_team": "Denver Nuggets",
        "away_team": "Brooklyn Nets",
        "scores": [
            {
                "name": "Denver Nuggets",
                "score": "124"
            },
            {
                "name": "Brooklyn Nets",
                "score": "104"
            }
        ],
        "last_update": "2022-02-06T22:50:22Z"
    },
    {
        "id": "aae8b3294ab2de36e63c614e44e94d80",
        "sport_key": "basketball_nba",
        "sport_title": "NBA",
        "commence_time": "2022-02-06T20:41:47Z",
        "completed": true,
        "home_team": "Minnesota Timberwolves",
        "away_team": "Detroit Pistons",
        "scores": [
            {
                "name": "Minnesota Timberwolves",
                "score": "118"
            },
            {
                "name": "Detroit Pistons",
                "score": "105"
            }
        ],
        "last_update": "2022-02-06T22:52:29Z"
    },
    {
        "id": "07767ff2952c6b025aa5584626db2910",
        "sport_key": "basketball_nba",
        "sport_title": "NBA",
        "commence_time": "2022-02-06T20:42:13Z",
        "completed": true,
        "home_team": "Chicago Bulls",
        "away_team": "Philadelphia 76ers",
        "scores": [
            {
                "name": "Chicago Bulls",
                "score": "108"
            },
            {
                "name": "Philadelphia 76ers",
                "score": "119"
            }
        ],
        "last_update": "2022-02-06T22:58:23Z"
    },
    {
        "id": "3f63cadf65ad249c5bc6b1aac8ba426d",
        "sport_key": "basketball_nba",
        "sport_title": "NBA",
        "commence_time": "2022-02-06T23:10:53Z",
        "completed": true,
        "home_team": "Orlando Magic",
        "away_team": "Boston Celtics",
        "scores": [
            {
                "name": "Orlando Magic",
                "score": "83"
            },
            {
                "name": "Boston Celtics",
                "score": "116"
            }
        ],
        "last_update": "2022-02-07T01:18:57Z"
    },
    {
        "id": "4843de62e910869ee34065ffe4c20137",
        "sport_key": "basketball_nba",

```

--------------------------------

### Example Response for Participants

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

The response contains a JSON array of participant objects, each with a full name and a unique ID. This list is treated as a whitelist.

```json
[
    {
        "full_name": "Arizona Cardinals",
        "id": "par_01hqmkr1xsfxmrj5pdq0f23asx"
    },
    {
        "full_name": "Atlanta Falcons",
        "id": "par_01hqmkr1xtexkbhkq7ct921rne"
    },
    {
        "full_name": "Baltimore Ravens",
        "id": "par_01hqmkr1xvev9rf557fy09k2cx"
    },
    {
        "full_name": "Buffalo Bills",
        "id": "par_01hqmkr1xwe6prjwr3j4gpqwx8"
    },
    {
        "full_name": "Carolina Panthers",
        "id": "par_01hqmkr1xxf2ebbqzb95qzxxxm"
    },
    {
        "full_name": "Chicago Bears",
        "id": "par_01hqmkr1xye20ahvp8fr2bvt74"
    },
    {
        "full_name": "Cincinnati Bengals",
        "id": "par_01hqmkr1xze7xbceshy9tka512"
    },
    {
        "full_name": "Cleveland Browns",
        "id": "par_01hqmkr1y0ez5bem3gdncd8a0d"
    },
    {
        "full_name": "Dallas Cowboys",
        "id": "par_01hqmkr1y1esas88pmaxe87by4"
    },
    {
        "full_name": "Denver Broncos",
        "id": "par_01hqmkr1y2e15tjsz9afcsj7da"
    },
    {
        "full_name": "Detroit Lions",
        "id": "par_01hqmkr1y3fex9sq94dgg1107y"
    },
    {
        "full_name": "Green Bay Packers",
        "id": "par_01hqmkr1y4ez38hyananses4hq"
    },
    {
        "full_name": "Houston Texans",
        "id": "par_01hqmkr1y5f63reha26n71p2jx"
    },
    {
        "full_name": "Indianapolis Colts",
        "id": "par_01hqmkr1y6f10rxbf8y2y2xthh"
    },
    {
        "full_name": "Jacksonville Jaguars",
        "id": "par_01hqmkr1y7e2r9kcn2qe0dt1d5"
    },
    {
        "full_name": "Kansas City Chiefs",
        "id": "par_01hqmkr1y8e9gt2q2rhmv196pv"
    },
    {
        "full_name": "Las Vegas Raiders",
        "id": "par_01hqmkr1y9fkaaeekn9w035jft"
    },
    {
        "full_name": "Los Angeles Chargers",
        "id": "par_01hqmkr1yafvas6wtv3jfs9f7a"
    },
    {
        "full_name": "Los Angeles Rams",
        "id": "par_01hqmkr1ybfmfb8mhz10drfe21"
    },
    {
        "full_name": "Miami Dolphins",
        "id": "par_01hqmkr1ycf7dsbr1997gz03y9"
    },
    {
        "full_name": "Minnesota Vikings",
        "id": "par_01hqmkr1ydf6vrfmd5f07caj88"
    },
    {
        "full_name": "New England Patriots",
        "id": "par_01hqmkr1yeffz9y9spwv8bx3na"
    },
    {
        "full_name": "New Orleans Saints",
        "id": "par_01hqmkr1yfe62tp0rvy8bn2jyc"
    },
    {
        "full_name": "New York Giants",
        "id": "par_01hqmkr1ygfzrv5sqe2v97c43e"
    },
    {
        "full_name": "New York Jets",
        "id": "par_01hqmkr1yhe4sb3y0wfzga67tf"
    },
    {
        "full_name": "Philadelphia Eagles",
        "id": "par_01hqmkr1yjedgakx37g743855e"
    },
    {
        "full_name": "Pittsburgh Steelers",
        "id": "par_01hqmkr1yker5bwcznt0b1jpj1"
    },
    {
        "full_name": "San Francisco 49ers",
        "id": "par_01hqmkr1ymfv0a8kfg96ha10ag"
    },
    {
        "full_name": "Seattle Seahawks",
        "id": "par_01hqmkr1ynfwaa91y9zvagkavd"
    },
    {
        "full_name": "Tampa Bay Buccaneers",
        "id": "par_01hqmkr1ypeszan8sq8dh7rqbg"
    },
    {
        "full_name": "Tennessee Titans",
        "id": "par_01hqmkr1yqexebpc06vyfwxqqm"
    },
    {
        "full_name": "Washington Commanders",
        "id": "par_01hqmkr1yrfsvbjjasn01a7xz4"
    }
]
```

--------------------------------

### Example API Request for 1 Market, 1 Region

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

Demonstrates an API call with a single market and a single region, resulting in a quota cost of 1.

```text
/v4/sports/americanfootball_nfl/events/a512a48a58c4329048174217b2cc7ce0/odds?markets=h2h&regions=us&...
```

--------------------------------

### Example: 3 Markets, 1 Region Cost

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

Illustrates the API request and calculated cost for multiple markets within a single region.

```text
/v4/historical/sports/americanfootball_nfl/events/a512a48a58c4329048174217b2cc7ce0/odds?markets=player_pass_tds,player_anytime_td,player_rush_longest&regions=us&...
```

--------------------------------

### Example Event Response

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

The response includes details for each event such as ID, sport, teams, and commencement time. Odds are not included in this response.

```json
[
    {
      "id": "a512a48a58c4329048174217b2cc7ce0",
      "sport_key": "americanfootball_nfl",
      "sport_title": "NFL",
      "commence_time": "2023-01-01T18:00:00Z",
      "home_team": "Atlanta Falcons",
      "away_team": "Arizona Cardinals"
    },
    {
      "id": "0ba747b1414a31b05ef37f0bf3d7fbe9",
      "sport_key": "americanfootball_nfl",
      "sport_title": "NFL",
      "commence_time": "2023-01-01T18:00:00Z",
      "home_team": "Tampa Bay Buccaneers",
      "away_team": "Carolina Panthers"
    },
    {
      "id": "d7120d8231032db343cb86b20cfaaf48",
      "sport_key": "americanfootball_nfl",
      "sport_title": "NFL",
      "commence_time": "2023-01-01T18:00:00Z",
      "home_team": "Detroit Lions",
      "away_team": "Chicago Bears"
    },
    {
      "id": "c7e2faa6faf714fbe08621a727604cd8",
      "sport_key": "americanfootball_nfl",
      "sport_title": "NFL",
      "commence_time": "2023-01-01T18:00:00Z",
      "home_team": "Washington Commanders",
      "away_team": "Cleveland Browns"
    },
    {
      "id": "2ed3fd0d267bbae31360e9f19d5adbab",
      "sport_key": "americanfootball_nfl",
      "sport_title": "NFL",
      "commence_time": "2023-01-01T18:00:00Z",
      "home_team": "Kansas City Chiefs",
      "away_team": "Denver Broncos"
    },
    ...
]
```

--------------------------------

### In-progress NBA Game Example

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

This JSON snippet shows an NBA game that is currently in progress. It includes current scores and the last update time.

```json
{
        "id": "4b25562aa9e87b57aa16f970abaec8cc",
        "sport_key": "basketball_nba",
        "sport_title": "NBA",
        "commence_time": "2022-02-07T02:11:01Z",
        "completed": false,
        "home_team": "Los Angeles Clippers",
        "away_team": "Milwaukee Bucks",
        "scores": [
            {
                "name": "Los Angeles Clippers",
                "score": "40"
            },
            {
                "name": "Milwaukee Bucks",
                "score": "37"
            }
        ],
        "last_update": "2022-02-07T02:47:23Z"
    }
```

--------------------------------

### Fetch live and upcoming American Football NFL games

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

This example shows how to retrieve only live and upcoming NFL games. The API call has a usage cost of 1.

```bash
curl "https://api.the-odds-api.com/v4/sports/americanfootball_nfl/scores?apiKey=..."
```

--------------------------------

### List of Sports API Response

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

This is an example response for the /v4/sports endpoint, detailing various sports with their keys, groups, titles, descriptions, and active status.

```json
[
    {
        "key": "americanfootball_ncaaf",
        "group": "American Football",
        "title": "NCAAF",
        "description": "US College Football",
        "active": true,
        "has_outrights": false
    },
    {
        "key": "americanfootball_nfl",
        "group": "American Football",
        "title": "NFL",
        "description": "US Football",
        "active": true,
        "has_outrights": false
    },
    {
        "key": "americanfootball_nfl_super_bowl_winner",
        "group": "American Football",
        "title": "NFL Super Bowl Winner",
        "description": "Super Bowl Winner 2021/2022",
        "active": true,
        "has_outrights": true
    },
    {
        "key": "aussierules_afl",
        "group": "Aussie Rules",
        "title": "AFL",
        "description": "Aussie Football",
        "active": true,
        "has_outrights": false
    },
    {
        "key": "baseball_mlb",
        "group": "Baseball",
        "title": "MLB",
        "description": "Major League Baseball",
        "active": true,
        "has_outrights": false
    },
    {
        "key": "basketball_nba",
        "group": "Basketball",
        "title": "NBA",
        "description": "US Basketball",
        "active": true,
        "has_outrights": false
    },
    {
        "key": "cricket_test_match",
        "group": "Cricket",
        "title": "Test Matches",
        "description": "International Test Matches",
        "active": true,
        "has_outrights": false
    },
    {
        "key": "golf_masters_tournament_winner",
        "group": "Golf",
        "title": "Masters Tournament Winner",
        "description": "2022 WInner",
        "active": true,
        "has_outrights": true
    },
    {
        "key": "golf_the_open_championship_winner",
        "group": "Golf",
        "title": "The Open Winner",
        "description": "2021 WInner",
        "active": true,
        "has_outrights": true
    },
    {
        "key": "golf_us_open_winner",
        "group": "Golf",
        "title": "US Open Winner",
        "description": "2021 WInner",
        "active": true,
        "has_outrights": true
    },
    {
        "key": "icehockey_nhl",
        "group": "Ice Hockey",
        "title": "NHL",
        "description": "US Ice Hockey",
        "active": true,
        "has_outrights": false
    },
    {
        "key": "mma_mixed_martial_arts",
        "group": "Mixed Martial Arts",
        "title": "MMA",
        "description": "Mixed Martial Arts",
        "active": true,
        "has_outrights": false
    },
    {
        "key": "rugbyleague_nrl",
        "group": "Rugby League",

```

--------------------------------

### Fetch completed American Football NFL scores

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

This example demonstrates how to fetch live and completed NFL games from the last 3 days. The API call incurs a usage cost of 2.

```bash
curl "https://api.the-odds-api.com/v4/sports/americanfootball_nfl/scores?daysFrom=3&apiKey=..."
```

--------------------------------

### Example Response for Event Markets

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

This is a sample JSON response for the event markets endpoint. It includes event details and a list of bookmakers, each with their available market keys and the last update time for those markets.

```json
{
    "id": "19699ba901294e39cb07fc4f19929a38",
    "sport_key": "baseball_mlb",
    "sport_title": "MLB",
    "commence_time": "2025-08-06T16:36:00Z",
    "home_team": "Philadelphia Phillies",
    "away_team": "Baltimore Orioles",
    "bookmakers": [
        {
            "key": "fanduel",
            "title": "FanDuel",
            "markets": [
                {
                    "key": "alternate_spreads",
                    "last_update": "2025-08-06T07:39:57Z"
                },
                {
                    "key": "batter_doubles",
                    "last_update": "2025-08-06T07:39:57Z"
                },
                {
                    "key": "batter_hits",
                    "last_update": "2025-08-06T07:39:57Z"
                },
                {
                    "key": "batter_home_runs",
                    "last_update": "2025-08-06T07:39:57Z"
                },
                ...

```

--------------------------------

### Example API Request for 3 Markets, 3 Regions

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

Presents an API call requesting multiple markets across multiple regions, yielding a quota cost of 9.

```text
/v4/sports/basketball_nba/events/0b83beff5f82f8623eea93dbc1d7cd4e/odds?markets=h2h,spreads,totals&regions=us,uk,au&...
```

--------------------------------

### Historical Events API Response Example

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

Example JSON response for historical events, including snapshot timestamps and event data. The 'data' array contains event details like ID, sport, commence time, and teams.

```json
{
    "timestamp": "2023-11-29T22:40:39Z",
    "previous_timestamp": "2023-11-29T22:35:39Z",
    "next_timestamp": "2023-11-29T22:45:40Z",
    "data": [
        {
            "id": "da359da99aa27e97d38f2df709343998",
            "sport_key": "basketball_nba",
            "sport_title": "NBA",
            "commence_time": "2023-11-30T00:10:00Z",
            "home_team": "Detroit Pistons",
            "away_team": "Los Angeles Lakers"
        },
        {
            "id": "0a502b246aa29f8ac2edb7a3ddf71ae9",
            "sport_key": "basketball_nba",
            "sport_title": "NBA",
            "commence_time": "2023-11-30T00:10:00Z",
            "home_team": "Orlando Magic",
            "away_team": "Washington Wizards"
        },
        {
            "id": "2667f897a67e6cdad61bd26a3b941d83",
            "sport_key": "basketball_nba",
            "sport_title": "NBA",
            "commence_time": "2023-11-30T00:40:00Z",
            "home_team": "Toronto Raptors",
            "away_team": "Phoenix Suns"
        },
        ...
    ]
}
```

--------------------------------

### GET odds

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

Returns a list of upcoming and live games with recent odds for a given sport, region and market.

```APIDOC
## GET odds

### Description
Returns a list of upcoming and live games with recent odds for a given sport, region and market.

### Method
GET

### Endpoint
/v4/sports/{sport}/odds/

### Parameters
#### Path Parameters
- **sport** (string) - The sport key obtained from calling the /sports endpoint. `upcoming` is always valid, returning any live games as well as the next 8 upcoming games across all sports.

#### Query Parameters
- **apiKey** (string) - Required - The API key associated with your subscription.
- **regions** (string) - Required - Determines the bookmakers to be returned. For example, `us`, `us2` (United States), `uk` (United Kingdom), `au` (Australia) and `eu` (Europe). Multiple regions can be specified if comma delimited.
- **markets** (string) - Optional - Determines which odds market is returned. Defaults to `h2h` (head to head / moneyline). Valid markets are `h2h` (moneyline), `spreads` (points handicaps), `totals` (over/under) and `outrights` (futures). Multiple markets can be specified if comma delimited.
- **dateFormat** (string) - Optional - Determines the format of timestamps in the response. Valid values are `unix` and `iso` (ISO 8601). Defaults to `iso`.
- **oddsFormat** (string) - Optional - Determines the format of odds in the response. Valid values are `decimal` and `american`. Defaults to `decimal`.
- **eventIds** (string) - Optional - Comma-separated game ids. Filters the response to only return games with the specified ids.
- **bookmakers** (string) - Optional - Comma-separated list of bookmakers to be returned. If both `bookmakers` and `regions` are both specified, `bookmakers` takes priority. Bookmakers can be from any region.
- **commenceTimeFrom** (string) - Optional - Filter the response to show games that commence on and after this parameter. Values are in ISO 8601 format, for example 2023-09-09T00:00:00Z. This parameter has no effect if the sport is set to 'upcoming'.
- **commenceTimeTo** (string) - Optional - Filter the response to show games that commence on and before this parameter. Values are in ISO 8601 format, for example 2023-09-10T23:59:59Z. This parameter has no effect if the sport is set to 'upcoming'.
- **includeLinks** (boolean) - Optional - if `true`, the response will include bookmaker links to events, markets, and betslips if available. Valid values are `true` or `false`.
- **includeSids** (boolean) - Optional - if `true`, the response will include source ids (bookmaker ids) for events, markets and outcomes if available. Valid values are `true` or `false`.
- **includeBetLimits** (boolean) - Optional - if `true`, the response will include the bet limit of each betting option, mainly available for betting exchanges. Valid values are `true` or `false`.
- **includeRotationNumbers** (boolean) - Optional - if `true`, the response will include the home and away rotation numbers if available. Valid values are `true` or `false`.

### Request Example
**GET** https://api.the-odds-api.com/v4/sports/americanfootball_nfl/odds/?apiKey=YOUR_API_KEY&regions=us&markets=h2h,spreads&oddsFormat=american

### Response
#### Success Response (200)
- **id** (string) - Unique identifier for the game.
- **sport_key** (string) - The key of the sport.
- **commence_time** (string) - The commencement time of the game in ISO 8601 format.
- **home_team** (string) - The name of the home team.
- **away_team** (string) - The name of the away team.
- **bookmakers** (array) - An array of bookmaker objects.
  - **key** (string) - The unique key for the bookmaker.
  - **title** (string) - The display name of the bookmaker.
  - **last_update** (string) - The last time the odds were updated in ISO 8601 format.
  - **markets** (array) - An array of market objects.
    - **key** (string) - The key of the market (e.g., `h2h`, `spreads`).
    - **outcomes** (array) - An array of outcome objects.
      - **name** (string) - The name of the outcome (e.g., team name, draw).
      - **price** (number) - The odds price for the outcome.
```

--------------------------------

### Example API Request for 3 Markets, 1 Region

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

Illustrates an API call requesting three markets within one region, leading to a quota cost of 3.

```text
/v4/sports/americanfootball_nfl/events/a512a48a58c4329048174217b2cc7ce0/odds?markets=h2h,spreads,totals&regions=us&...
```

--------------------------------

### Get List of In-Season Sports

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

Use this endpoint to retrieve a list of sports that are currently in season. The 'key' from the response can be used in subsequent requests.

```json
{
  "key": "americanfootball_nfl",
  "group": "American Football",
  "title": "NFL",
  "description": "US Football",
  "active": true,
  "has_outrights": false
},
```

--------------------------------

### Example Historical Odds API Request URL

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

Demonstrates how to construct a URL for fetching historical odds, specifying markets and regions. The cost is calculated based on the number of markets and regions requested.

```text
/v4/historical/sports/americanfootball_nfl/odds?markets=h2h&regions=us&...
```

```text
/v4/historical/sports/americanfootball_nfl/odds?markets=h2h,spreads,totals&regions=us&...
```

```text
/v4/historical/sports/soccer_epl/odds?markets=h2h&regions=us,uk,eu&...
```

```text
/v4/historical/sports/basketball_nba/odds?markets=h2h,spreads,totals&regions=us,uk,au&...
```

--------------------------------

### Upcoming NBA Game Example

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

This JSON snippet represents an upcoming NBA game with no scores available yet. The 'scores' and 'last_update' fields are null.

```json
{
        "id": "19434a586e3723c55cd3d028b90eb112",
        "sport_key": "basketball_nba",
        "sport_title": "NBA",
        "commence_time": "2022-02-08T00:10:00Z",
        "completed": false,
        "home_team": "Charlotte Hornets",
        "away_team": "Toronto Raptors",
        "scores": null,
        "last_update": null
    }
```

--------------------------------

### Example Odds API Response Structure

Source: https://the-odds-api.com/liveapi/guides/v4/index.html

This is a sample JSON response structure for odds data. It includes game details, bookmaker information, market types, and odds for each outcome. The 'commence_time' is in ISO 8601 format by default.

```json
[
    {
        "id": "bda33adca828c09dc3cac3a856aef176",
        "sport_key": "americanfootball_nfl",
        "commence_time": "2021-09-10T00:20:00Z",
        "home_team": "Tampa Bay Buccaneers",
        "away_team": "Dallas Cowboys",
        "bookmakers": [
            {
                "key": "unibet",
                "title": "Unibet",
                "last_update": "2021-06-10T13:33:18Z",
                "markets": [
                    {
                        "key": "h2h",
                        "outcomes": [
                            {
                                "name": "Dallas Cowboys",
                                "price": 240
                            },

```
Tokens:
Raw