# Is GetOdds compatible with The Odds API v4?

Yes for five endpoints: GetOdds (getoddsapi.com) answers /v4/sports, /v4/sports/{sport}/events, /v4/sports/{sport}/odds, /v4/sports/{sport}/events/{eventId}/odds and /v4/sports/{sport}/scores with The Odds API’s JSON shape, sport keys, bookmaker keys and apiKey parameter, serving DraftKings, FanDuel and BetRivers (region us), Novig (us_ex) and Pinnacle (eu) game lines plus player props per event, so a v4 client works by changing only the host; historical snapshots, live in-play odds and other bookmakers are not served.

Canonical page: https://getoddsapi.com/the-odds-api-compatible

**Price.** Free development allowance: 1,000 requests per UTC day and 60 per minute per account, with no payment step. Paid plans from $5 a month for 100,000 credits to $99 for 15 million, self-serve at /pricing. /v4/sports/{sport}/odds, per-event odds and scores use one credit per request whatever the number of markets and regions; /v4/sports and /v4/sports/{sport}/events are free.

## Free API key

Get a free GetOdds API key: **1,000 requests per UTC day and 60 per minute, no card**. One key covers REST and the hosted MCP server.

Sign up: https://getoddsapi.com/sign-up?ref=ai-claudebot

## Quickstart

1. Create an account at https://getoddsapi.com/sign-up?ref=ai-claudebot, open https://getoddsapi.com/dashboard and issue a key with the sources you need (draftkings, fanduel, betrivers, prizepicks or underdog). Keep it in a server environment variable named GETODDS_API_KEY.
2. Read current DraftKings NBA spreads with curl:

```bash
curl --fail-with-body "https://getoddsapi.com/api/v1/odds?sport=NBA&market=spread&fresh_only=true&limit=50" \
  -H "Authorization: Bearer $GETODDS_API_KEY"
```

3. The same request in Python (standard library only):

```python
import json, os, urllib.request

req = urllib.request.Request(
    "https://getoddsapi.com/api/v1/odds?sport=NBA&market=spread&fresh_only=true&limit=50",
    headers={"Authorization": "Bearer " + os.environ["GETODDS_API_KEY"]},
)
with urllib.request.urlopen(req) as res:
    rows = json.load(res)["data"]
for row in rows:
    print(row["away"], "at", row["home"], row["side"], row["line"], row["american"], row["observed_at"])
```

4. Check `observed_at`, `age_seconds` and `stale` on every row before using a price. Full reference: https://getoddsapi.com/docs

## Use with Claude (MCP)

```bash
claude mcp add --transport http getodds https://getoddsapi.com/api/mcp \
  --header "Authorization: Bearer $GETODDS_API_KEY"
```

The MCP tools follow the key's source grants and share its allowance. Setup guide: https://getoddsapi.com/use-with-claude

SDKs: `pip install getodds` (PyPI) · `npm install getoddsapi` (npm) · `npx -y getodds-mcp` (local MCP server) · R: `remotes::install_github("getoddsapi/getodds-r")`. Source: https://github.com/getoddsapi · https://getoddsapi.com/docs/sdks

## Pricing

| Plan | Allowance | Price |
| --- | --- | --- |
| Free key | 1,000 requests a day, 60 a minute | $0, no card |
| Starter | 100,000 credits a month, 120 a minute | $5 a month |
| Pro | 750,000 credits a month, 300 a minute | $19 a month |
| Business | 3,000,000 credits a month, 600 a minute | $39 a month |
| Scale | 15,000,000 credits a month, 1,200 a minute | $99 a month |

Free development allowance: 1,000 requests per UTC day and 60 per minute per account, with no payment step. Paid plans from $5 a month for 100,000 credits to $99 for 15 million, self-serve at /pricing.
Details: https://getoddsapi.com/pricing

## Facts

- **Endpoints:** 5 of The Odds API v4
- **Bookmakers:** draftkings, fanduel, betrivers, pinnacle, novig; underdog for props
- **Markets:** h2h, spreads, totals; player_* props per event
- **Auth:** apiKey parameter or bearer header
- **Odds cost:** 1 credit per request

## Compatibility matrix

Checked against the GetOdds v4 handler on 16 November 2026. Anything GetOdds cannot serve answers with an error in The Odds API’s shape ({message, error_code, details_url}) instead of an empty success.

| v4 feature | GetOdds | Notes |
| --- | --- | --- |
| GET /v4/sports | Served, 0 credits | all=true supported; has_outrights is always false |
| GET /v4/sports/{sport}/events | Served, 0 credits | eventIds, commenceTimeFrom, commenceTimeTo, dateFormat |
| GET /v4/sports/{sport}/odds | Served, 1 credit | regions or bookmakers; markets h2h, spreads, totals; oddsFormat american or decimal; dateFormat iso or unix; eventIds; commence time filters |
| GET /v4/sports/{sport}/events/{eventId}/odds | Served, 1 credit | Game lines plus player props: player_points, player_rebounds, player_assists, player_threes, player_points_rebounds_assists and other NBA/NCAAB keys; player_pass_yds, player_rush_yds, player_reception_yds, player_receptions and more for NFL/NCAAF; player_shots_on_goal, player_points, player_goals, player_total_saves for NHL |
| GET /v4/sports/{sport}/scores | Served, 1 credit | Upcoming and live games; daysFrom=1..3 adds completed ones. From the ESPN scoreboard, not sportsbook settlement |
| Bookmakers | 5 books, plus 1 for props | draftkings, fanduel, betrivers (us); novig (us_ex, the exchange ask); pinnacle (eu); underdog (us_dfs, priced props only) |
| Sport keys | 13 mapped | NFL, NCAAF, NBA, NCAAB, NHL, MLB, EPL, MLS, Champions League, Bundesliga, La Liga, Serie A, Ligue 1 |
| Other bookmakers and regions | Dropped | Unknown books are listed in x-getodds-unsupported-bookmakers; regions us2, uk, au alone answer 422 INVALID_REGION |
| Alternate lines, anytime TD, outrights | Not served | Dropped and listed in x-getodds-unsupported-markets |
| Live in-play odds | Not served | Pregame only: an event that has started carries no bookmakers |
| /v4/historical/... | Not served | Use /api/v1/history, /api/v1/historical/closing-lines and the history archive |
| Usage headers | Served | x-requests-used, x-requests-remaining and x-requests-last, counted from your GetOdds allowance (requests today on Free, credits this period on paid plans) |
| Event IDs | Different | GetOdds IDs such as espn-draftkings:espn:NBA:401909988 (fanduel:<id> for games only FanDuel lists), not The Odds API’s 32-character IDs |

## Switch a v4 client by changing the host

The same Python that calls The Odds API works against GetOdds. Send the key as a bearer header if you can; apiKey in the query string also works but ends up in logs.

```python
import json, os, urllib.request

BASE = "https://getoddsapi.com"          # was https://api.the-odds-api.com
url = BASE + "/v4/sports/basketball_nba/odds?regions=us,us_ex,eu&markets=h2h,spreads,totals&oddsFormat=american"
req = urllib.request.Request(url, headers={"Authorization": "Bearer " + os.environ["GETODDS_API_KEY"]})
with urllib.request.urlopen(req, timeout=20) as res:
    print("requests remaining:", res.headers["x-requests-remaining"])
    for event in json.load(res):
        for book in event["bookmakers"]:
            for market in book["markets"]:
                print(event["away_team"], "@", event["home_team"], book["key"], market["key"], market["outcomes"])
```

## Player props, one event at a time

As on The Odds API, props come from the per-event route. Each outcome is {name: Over or Under, description: player, price, point}. PrizePicks and DK Pick6 lines carry no price, so they are not on this route; /api/v1/props has them next to every sportsbook.

```bash
curl -sS "https://getoddsapi.com/v4/sports/basketball_nba/events/$EVENT_ID/odds?regions=us,us_ex&markets=player_points,player_rebounds&oddsFormat=american" \
  -H "Authorization: Bearer $GETODDS_API_KEY"
```

## When the v4 path is not enough

GetOdds’ native routes add what the v4 shape has no field for: observed_at and age per price, line history, closing lines, Novig bid and fair prices, and pick’em lines. The migration guide maps each v4 call to its native route.

If your app depends on books GetOdds does not carry (BetMGM, Caesars, bet365), live in-play odds or historical snapshots before November 2026, keep The Odds API for those calls.

## FAQ

### Do I need to change my parsing code?

No: the v4 routes return the same events, bookmakers, markets and outcomes nesting, with point on spreads, totals and props and description (the player) on prop outcomes.

### Which bookmakers does the GetOdds v4 path return?

draftkings, fanduel and betrivers for regions=us, novig for us_ex and pinnacle for eu, each with its own prices; underdog joins for player props on the per-event route.

### Does GetOdds accept the apiKey query parameter?

Yes, apiKey=<key> works, as does an Authorization: Bearer header, which keeps the key out of logs.

### Does the v4 odds call cost the same as on The Odds API?

No. GetOdds charges one credit per request whatever the number of markets and regions; The Odds API charges one credit per market per region.

### Are event IDs the same as The Odds API’s?

No. GetOdds uses its own IDs, so map events by teams and commence time when you run both providers side by side.

---

GetOdds (getoddsapi.com) is an independent developer product and is not affiliated with any sportsbook or pick’em operator. GetOdds is a separate product from The Odds API (the-odds-api.com) and from Odds-API.io (odds-api.io), and is not affiliated with either. Prices describe data, not betting advice.

GetOdds is operated by Stunning Couches LLC, a Delaware limited liability company. Terms: https://getoddsapi.com/terms · Privacy: https://getoddsapi.com/privacy
