# College basketball odds API: NCAAB lines from DraftKings and FanDuel

GetOdds returns NCAAB (men’s college basketball) spreads, totals and moneylines from DraftKings, captured through ESPN and the DraftKings New Jersey catalog, and native FanDuel NCAAB markets, each with the time it was observed. Use sport=NCAAB on /api/v1/odds for DraftKings and league=NCAAB on /api/v1/sportsbook/markets for FanDuel.

Canonical page: https://getoddsapi.com/college-basketball-odds-api

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

- **Sportsbooks:** DraftKings, FanDuel
- **Markets:** Spread, total, moneyline
- **History:** Kept since November 2026, per offer or event
- **Not covered:** BetRivers NCAAB, women’s college basketball

## Read tonight’s college basketball lines

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.

A college slate can run past 100 games on a Saturday. Page with limit=200 and read /api/v1/odds/updated afterwards so you only fetch prices that moved.

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

curl --fail-with-body "https://getoddsapi.com/api/v1/odds/updated?sport=NCAAB&since=$SINCE&limit=200" \
  -H "Authorization: Bearer $GETODDS_API_KEY"
```

## Add FanDuel NCAAB markets

FanDuel must be selected once per account. Its NCAAB rows keep FanDuel’s native IDs; college team names are not matched across books automatically, because FanDuel abbreviates some of them.

```bash
# DraftKings is selected by default. FanDuel and BetRivers must be selected once per account.
curl --fail-with-body -X PUT \
  "https://getoddsapi.com/api/v1/bookmakers/selected/select?bookmakers=draftkings,fanduel,betrivers" \
  -H "Authorization: Bearer $GETODDS_API_KEY"

curl --fail-with-body "https://getoddsapi.com/api/v1/sportsbook/markets?league=NCAAB&limit=100" \
  -H "Authorization: Bearer $GETODDS_API_KEY"
```

## Fields on each NCAAB odds row

College basketball rows use the same schema as every other league.

| Field | Meaning |
| --- | --- |
| id, event_id | Source-native offer and event IDs, for example espn-draftkings:espn:NBA:401909287 |
| sport | League code: NFL, NBA, NHL, NCAAF, NCAAB, MLB, EPL or MLS |
| home, away, starts_at | Teams and scheduled start (UTC ISO 8601) |
| market, period, side | moneyline, spread or total; the period; home, away, draw, over or under |
| line | Spread or total number; null on a moneyline |
| american, decimal | The recorded price in both formats |
| observed_at, age_seconds, stale | When the price was captured, its age, and whether it is older than 900 seconds |

## FAQ

### Which sportsbooks does the college basketball odds API cover?

DraftKings (through ESPN and its New Jersey catalog) and FanDuel (native New Jersey feed). BetRivers college basketball is not collected.

### Are smaller conferences included?

Whatever the books post is collected; small-conference games often have only a spread and total, and some get no line at all.

### Can I match the same game across DraftKings and FanDuel?

Use /api/v1/mappings, which links events only when names, league and start time match exactly. Some college names will not match, and those games stay unmapped rather than guessed.

---

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
