# Pinnacle odds API: the sharp reference line as JSON

GetOdds serves Pinnacle pregame moneylines, spreads, totals and team totals for the NFL, NCAAF, NBA, NCAAB, NHL, EPL, MLS, Champions League and Bundesliga, plus NFL player and game props, from /api/v1/pinnacle/markets with any free key. Prices are read through from Pinnacle’s public guest feed at request time (reused for at most 20 seconds), so there is no stored Pinnacle history.

Canonical page: https://getoddsapi.com/sportsbooks/pinnacle

**Price.** Free: 1,000 requests per UTC day and 60 per minute, no card. Paid credit plans start at $5 a month for 100,000 credits; see /pricing.

## 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

- **Type:** Sportsbook
- **Leagues:** NFL, NCAAF, NBA, NCAAB, NHL, EPL, MLS, Champions League, Bundesliga
- **Markets:** Moneyline, spread, total, team total; NFL player and game props as specials
- **Endpoint:** /api/v1/pinnacle/markets?league=NFL
- **Key grant:** any key
- **Scope:** International (not US-licensed); Pinnacle guest feed, read through

## Read Pinnacle with one request

Create an account at /sign-up, open /dashboard and issue a key with the source grants you need (draftkings, fanduel, betrivers, prizepicks or underdog). Keep the key in a server environment variable named GETODDS_API_KEY and send it as a bearer token. Never put it in a URL or in browser code.

```bash
curl --fail-with-body "https://getoddsapi.com/api/v1/pinnacle/markets?league=NFL&limit=50" \
  -H "Authorization: Bearer $GETODDS_API_KEY"
```

## Use Pinnacle as the no-vig reference

Pinnacle is the usual sharp reference for devigging and closing-line checks. Read the same game from DraftKings or FanDuel and compare. Pinnacle is an international book, not licensed in US states; GetOdds labels every row with that jurisdiction.

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

## What a Pinnacle row contains

Field names below are from the endpoint’s published contract at /openapi.json.

| Field | Meaning |
| --- | --- |
| event, starts_at | Native event identity and scheduled start (UTC) |
| market, selection, line | The native market name, the outcome and its handicap or total |
| american, decimal | The price as the book displays it |
| observed_at | When GetOdds read the price; compare it with your own freshness rule |

## Pinnacle data: GetOdds, The Odds API and ParlayAPI

Plans and book lists copied from each provider’s public pages on 15 November 2026. Where GetOdds is narrower, it says so: The Odds API and ParlayAPI cover far more books, and one of their credits covers every book in a region for a market, while one GetOdds credit reads one source.

| Provider | Carries Pinnacle? | Free tier | Lowest paid plan | What one credit buys |
| --- | --- | --- | --- | --- |
| GetOdds | Yes | 1,000 credits per UTC day, no card | $5 a month for 100,000 credits | One request to one source (one book or board) |
| The Odds API | Yes, key pinnacle | 500 credits a month | $30 a month for 20,000 credits | One market in one region, every book in that region |
| ParlayAPI | Says it lists 30+ sportsbooks; we have not checked this book on its list | 1,000 credits a month | $5 a month for 20,000 credits | One market in one region |

## FAQ

### Where does GetOdds get Pinnacle odds?

From the public guest feed that Pinnacle’s own website reads, with no Pinnacle account. GetOdds normalizes it to JSON and stamps each row with observed_at.

### Is Pinnacle history available?

No. Pinnacle prices are read through at request time and not stored, so GetOdds has no Pinnacle line history or closing lines.

### Are Pinnacle props included?

NFL player and game props are returned as market=special with Pinnacle’s own category label. On 15 November 2026 the NBA board listed no player props.

### How much does Pinnacle data cost on GetOdds?

Nothing to start: a free key gives 1,000 requests a day and 60 a minute with no card, and every plan reads the same sources. Paid credit plans start at $5 a month for 100,000 credits.

## Sources checked

- [The Odds API bookmaker list](https://the-odds-api.com/sports-odds-data/bookmaker-apis.html)
- [ParlayAPI](https://parlay-api.com/)

---

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
