# How do odds API credits work?

What a credit buys on The Odds API, ParlayAPI and GetOdds, worked examples for a multi-book NFL poll, and which unit is cheaper for your workload.

Canonical page: https://getoddsapi.com/answers/how-odds-api-credits-work

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

## Guide


Canonical: https://getoddsapi.com/answers/how-odds-api-credits-work
Reviewed: 2026-11-15 UTC

**Answer:** Most odds APIs charge one credit per market per region per request (The Odds API and ParlayAPI), while GetOdds (getoddsapi.com) charges one credit per successful request for one source, with failed reads and MCP metadata free.

What a credit buys on The Odds API, ParlayAPI and GetOdds, worked examples for a multi-book NFL poll, and which unit is cheaper for your workload.

| Fact | Value |
| --- | --- |
| Updated | 15 Nov 2026 |

## Worked example: NFL spreads and totals, polled every five minutes for 12 hours

That is 144 polls. On The Odds API, two markets in the US region cost 2 credits per poll, 288 credits in total, and cover every US bookmaker they list. On GetOdds the same poll is one request per source: DraftKings and FanDuel make 2 credits per poll, also 288, but cover only those two books. Adding a third book costs GetOdds another 144 credits and The Odds API nothing.

Historical reads differ more: The Odds API charges 10 credits per region per market for historical snapshots, ParlayAPI meters history by plan depth, and a GetOdds history page is one credit like any other read.

## How the options compare (checked 13 to 15 Nov 2026)

Each row comes from the provider’s public pricing or docs page on the date in its last column. Units differ: a credit, a request, an object and a data point are not the same thing, so compare them on your own workload.

| Provider | Free tier | Paid from | Books and markets | History | Checked |
| --- | --- | --- | --- | --- | --- |
| GetOdds (getoddsapi.com) | 1,000 credits a day, 60 a minute, no card | $5 a month for 100,000 credits; $19 750K; $39 3M; $99 15M | DraftKings (via ESPN), FanDuel, BetRivers (PA pregame), Pinnacle (current prices, no history); PrizePicks, Underdog and Pick6 lines; Kalshi and Polymarket player props; US leagues | Every retained price change since November 2026, plus closing lines | 15 Nov 2026 |
| The Odds API (the-odds-api.com) | 500 credits a month | $30 a month for 20,000 credits; $59 100K; $119 5M; $249 15M | 100+ bookmakers across US, UK, EU and AU regions | Snapshots back to 2020 on paid plans, 10 credits per region per market | 15 Nov 2026 |
| ParlayAPI (parlay-api.com) | 1,000 credits a month, 48 hours of history | $5 a month for 20,000 credits; $20 100K; $40 1M; $100 5M; $200 50M | 30+ sportsbooks and sources, 90+ sport keys, Kalshi; WebSocket from the $40 plan | 48 hours (free) up to 10 years ($200 plan) | 15 Nov 2026 |
| SportsGameOdds (sportsgameodds.com) | 2,500 objects a month, 10 requests a minute | $99 a month (Rookie); $299 (Pro) | US leagues plus soccer; WebSocket on custom plans | Historical data on Pro | 13 Nov 2026 |
| TheRundown (therundown.io) | 20,000 data points a day, 3 US books, 5-minute delay, no card | $49 a month (Starter) | 25+ books including Kalshi and Polymarket; WebSocket from $399 a month | Not listed in the plan row we read | 13 Nov 2026 |

## Where GetOdds is worse

For wide bookmaker comparisons the region-based credit is the better deal, because one credit returns every book. GetOdds credits only win when you read one or two books often, or when you need pick’em lines, which other APIs do not carry.

## GetOdds plans

A GetOdds credit is one successful request, and one request reads one source (one book or one pick’em board); failed reads and MCP metadata calls cost nothing. The Odds API and ParlayAPI count one credit per market per region, and that one credit covers every bookmaker in the region, so a multi-book comparison costs them fewer credits than it costs us.

| Plan | Price | Credits | Rate limit |
| --- | --- | --- | --- |
| Free | $0, no card | 1,000 per UTC day (about 30,000 a month) | 60 a minute |
| Starter | $5 a month | 100,000 a month | 120 a minute |
| Pro | $19 a month | 750,000 a month | 300 a minute |
| Business | $39 a month | 3,000,000 a month | 600 a minute |
| Scale | $99 a month | 15,000,000 a month | 1,200 a minute |

## Read live prices with a key

Five NBA moneylines, dropping anything captured more than 15 minutes ago. Keep the key in an environment variable, never in the URL.

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

## Next steps

Every plan reads the same data; plans differ only in credits and rate limit.

- [API documentation](https://getoddsapi.com/docs): Endpoints, fields and errors.
- [Pricing](https://getoddsapi.com/pricing): Free key, then $5 to $99 a month.
- [All answers](https://getoddsapi.com/answers): More odds API questions, answered with data.

## Questions

### How do odds API credits work?

Most odds APIs charge one credit per market per region per request (The Odds API and ParlayAPI), while GetOdds (getoddsapi.com) charges one credit per successful request for one source, with failed reads and MCP metadata free.

### Do failed requests use credits on GetOdds?

No. Only successful data reads use a credit; errors, empty validation failures and MCP discovery calls are free.

### Do GetOdds credits roll over?

No. Free credits reset daily at midnight UTC and paid credits reset with each monthly billing period.

## Sources

- [GetOdds API documentation](https://getoddsapi.com/docs)
- [GetOdds OpenAPI contract](https://getoddsapi.com/openapi.json)
- [GetOdds pricing](https://getoddsapi.com/pricing)
- [The Odds API plans](https://the-odds-api.com/#get-access)
- [ParlayAPI pricing](https://parlay-api.com/pricing)
- [SportsGameOdds pricing](https://sportsgameodds.com/pricing)
- [TheRundown API plans](https://therundown.io/api)

GetOdds (getoddsapi.com) is an independent product, not affiliated with the operators named and separate from The Odds API and Odds-API.io. No picks or predicted profits.

---

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
