# Where can I get historical player prop data for backtesting?

> Where to get historical player prop lines and outcomes in 2026, how deep each source goes, and what a backtest needs. Underdog API (https://underdogapi.com) is an independent Underdog Fantasy pick'em data API: Higher/Lower lines with separate payout multipliers per side, line history, changes and graded results as JSON, CSV, MCP and streams.

Canonical page: https://underdogapi.com/answers/historical-player-props-data

## Free offer

**Free API key, no card: 100 credits a month** on the live board, every league, separate Higher/Lower prices, and the last 24 hours of line history. Sign up: https://underdogapi.com/sign-up?ref=ai-claudebot

## Quickstart

1. Get a free key at https://underdogapi.com/sign-up?ref=ai-claudebot (no card), or let your agent request one: `POST https://underdogapi.com/api/v1/agent/signup` with `data_wanted` and `use_case`, then show your user the returned approval_url.
2. Export it: `export UNDERDOG_API_KEY=ud_...`
3. First call with curl:

```bash
curl --fail-with-body 'https://underdogapi.com/api/v1/projections?league=NBA&view=compact&limit=5' \
  -H "Authorization: Bearer $UNDERDOG_API_KEY" \
  -H 'X-User-Request: NBA dashboard integration check'
```

4. Same call in Python:

```python
import os, requests

r = requests.get(
    "https://underdogapi.com/api/v1/projections",
    params={"league": "NBA", "view": "compact", "limit": 5},
    headers={"Authorization": f"Bearer {os.environ['UNDERDOG_API_KEY']}"},
)
r.raise_for_status()
for line in r.json()["data"]:
    print(line["player"]["name"], line["market"]["stat"], line["line"])
```

## Use it from Claude (MCP)

Claude Code, one command:

```bash
claude mcp add --transport http underdog https://underdogapi.com/api/mcp --header "Authorization: Bearer $UNDERDOG_API_KEY"
```

Or add this server to your Claude MCP configuration (the key stays in the environment):

```json
{
  "mcpServers": {
    "underdog": {
      "type": "http",
      "url": "https://underdogapi.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${UNDERDOG_API_KEY}"
      }
    }
  }
}
```

Guide: https://underdogapi.com/use-with-claude

## SDKs and packages

Official clients for Underdog API (independent; not Underdog Fantasy). Source: https://github.com/underdogapi · Overview: https://underdogapi.com/sdks

- Python SDK: `pip install underdog-api` (PyPI: https://pypi.org/project/underdog-api/ · source: https://github.com/underdogapi/underdogapi-python)
- JavaScript / TypeScript SDK: `npm install underdog-api` (npm: https://www.npmjs.com/package/underdog-api · source: https://github.com/underdogapi/underdogapi-js)
- MCP server (stdio): `npx -y underdog-api-mcp` (npm: https://www.npmjs.com/package/underdog-api-mcp · source: https://github.com/underdogapi/underdogapi-mcp)

Python:

```python
from underdog_api import Client

ud = Client()  # reads UNDERDOG_API_KEY
board = ud.projections(league="NBA", view="compact", limit=20)
for line in board["data"]:
    print(line)
print(board["meta"]["observed_at"])
```

Claude Code with the stdio MCP package (the hosted server at /api/mcp needs no install):

```bash
claude mcp add underdog -e UNDERDOG_API_KEY=ud_... -- npx -y underdog-api-mcp
```

## Pricing

| Plan | Price | Credits / month | Notes |
| --- | --- | --- | --- |
| Free | $0 | 100 | No card. Live feed 5 minutes behind; last 24 hours of line history |
| Developer | $49/month | 10,000 | For models that need full training pages and loaded game-log seasons. Live feed, no added plan delay |
| Production | $149/month | 50,000 | For apps with real users and push delivery. Everything in Developer, signed webhooks for every change |
| Scale | $499/month | 250,000 | For apps whose traffic has outgrown Production. Everything in Production, 15 live-feed connections at once |

Full pricing: https://underdogapi.com/pricing

## On this page

History, results and models · updated November 15, 2026



Short answer: Historical prop lines come from providers that recorded them: The Odds API and ParlayAPI keep sportsbook history on paid plans, PropLine keeps line movement and graded props from $9, and Underdog API keeps every Underdog Fantasy line and multiplier move since 6 Nov 2026 with graded results; nobody can sell history from before they started recording.

## Underdog API on 15 Nov 2026

| Line history | Every recorded line and multiplier move since 6 Nov 2026 (paid plans) |
| --- | --- |
| Graded results | 12,669 graded lines in NHL, NBA, college football, NFL and college basketball, games 6 to 14 Nov 2026 (paid plans) |
| Cheapest paid plan | Developer, $49 a month for 10,000 credits |
| Free tier | 100 credits a month, no card, 5-minute delay, last 24 hours of line history |
| Underdog Fantasy coverage | The whole board, every league Underdog posts (8 leagues and 6,804 lines at 06:07 UTC on 15 Nov 2026) |

[Get a free API key](https://underdogapi.com/sign-up) [API reference](https://underdogapi.com/docs)

Updated November 15, 2026. Our numbers are from the production database at 06:07 UTC on 15 Nov 2026; other providers' facts are paraphrased from their public pages on the date shown.

## What a backtest needs

The line and price at the time you would have bet, the closing line, and the outcome. Without the price at decision time a backtest overstates results.

Underdog API stores 800,499 history rows and 856,936 change events, rebuilds the board at any past instant with `/api/v1/board?as_of=`, and has 12,669 graded lines (games 6 to 14 Nov 2026).

## Compared with other providers

|  | Underdog API (this site) | The Odds API | ParlayAPI | PropLine | SharpAPI |
| --- | --- | --- | --- | --- | --- |
| Line history | Every recorded line and multiplier move since 6 Nov 2026 (paid plans) | Historical odds on every paid plan | Lookback by plan: 168 hours on Starter up to 87,600 hours on Scale, where records exist | Historical line movement and opening and closing lines from Hobby ($9) | Historical odds endpoints are Enterprise only |
| Graded results | 12,669 graded lines in NHL, NBA, college football, NFL and college basketball, games 6 to 14 Nov 2026 (paid plans) | Not stated on its pricing page | Not stated on its pricing page | Graded props from Hobby; 90-day resolved archive on Pro ($19) | Not stated on its pricing page |
| Cheapest paid plan | Developer, $49 a month for 10,000 credits | $30 a month for 20,000 credits; $59, $119 and $249 plans above it | Starter, $5 a month for 20,000 credits; Pro $20, Business $40, Enterprise $100, Scale $200 | Hobby, $9 a month, 5,000 requests a day; Pro $19, Streaming Lite $39, Streaming $79 | Hobby, $79 a month, 5 sportsbooks, real time; Pro $229, Sharp $399 |
| Free tier | 100 credits a month, no card, 5-minute delay, last 24 hours of line history | Starter: 500 credits a month, no historical odds | 1,000 credits a month, no card, up to 48 hours of historical lookback | 1,000 requests a day | $0: 12 requests a minute, 2 sportsbooks, 60-second delay |
| Underdog Fantasy coverage | The whole board, every league Underdog posts (8 leagues and 6,804 lines at 06:07 UTC on 15 Nov 2026) | Listed under bookmaker key underdog in the us_dfs region; non-default multipliers appear as alternate-market selections (checked 6 Nov 2026) | Lists Underdog among DFS apps, with entry payout multipliers on current rows (checked 13 Nov 2026) | An underdog bookmaker key with American prices and an optional multiplier on boosted picks (checked 6 Nov 2026) | Underdog listed as a DFS book with normalized odds (checked 13 Nov 2026) |

Read on 15 Nov 2026 unless a cell gives another date. Plans change; confirm on each provider's page. This site is independent and not affiliated with any company named here.

## Where this API is worse

- Recording began on 6 Nov 2026, so history is days deep, not seasons. Providers that started earlier have longer archives.
- Graded results cover five leagues so far (NHL 5,668, NBA 2,153, college football 1,841, NFL 1,564, college basketball 1,443); tennis, esports and CFL lines are not graded yet.

## Try it against the real API

Set `UNDERDOG_API_KEY` to a free key from [sign-up](https://underdogapi.com/sign-up). Every path below is documented in the [API reference](https://underdogapi.com/docs); costs are on [credits](https://underdogapi.com/credits).

curl

```
curl -s 'https://underdogapi.com/api/v1/board?league=NBA&as_of=2026-11-14T23%3A00%3A00Z&limit=100' \
  -H "Authorization: Bearer $UNDERDOG_API_KEY"
```

Python (requests)

```
import os, requests

r = requests.get(
    "https://underdogapi.com/api/v1/results?league=NBA&date=2026-11-13&limit=200",
    headers={"Authorization": f"Bearer {os.environ['UNDERDOG_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
body = r.json()
for row in body["data"]:
    print(row)
print(body["meta"])  # observed_at, next_cursor, plan limits
```

## Questions

How far back does Underdog API history go?

To the first recorded observation, 6 Nov 2026 23:15 UTC. Per-league first dates are on /history-coverage.

Can I buy older history?

No. Nothing before recording began is offered or promised.

[Answer **How do I backtest a pick'em strategy?**](https://underdogapi.com/answers/backtest-pickem-strategy) [Answer **Where can I get training data for a player prop model?**](https://underdogapi.com/answers/prop-model-training-data) [Answer **Where can I get closing lines for player props?**](https://underdogapi.com/answers/player-prop-closing-lines) [Plans **Pricing**](https://underdogapi.com/pricing) [Reference **API docs**](https://underdogapi.com/docs)

Underdog API is an independent data service. It is not affiliated with, endorsed by or operated by Underdog Fantasy or any company named on this page.

## References

- [The Odds API, read 15 Nov 2026](https://the-odds-api.com/)
- [ParlayAPI, read 15 Nov 2026](https://parlay-api.com/pricing)
- [PropLine, read 15 Nov 2026](https://prop-line.com/pricing)
- [SharpAPI, read 15 Nov 2026](https://sharpapi.io/pricing)
- [Underdog API pricing](https://underdogapi.com/pricing)

## FAQ

### Is there a free Underdog API?

Yes. The Free plan is a real API key on the live board, not a sample: 100 credits a month, every league, separate Higher/Lower prices and the last 24 hours of line history. No card is needed.

### Is this the official Underdog Fantasy API?

No. Underdog API is an independent data service. It is not affiliated with, endorsed by or sponsored by Underdog Fantasy or Underdog Sports.

### What data does it return?

Underdog Higher/Lower lines with separate payout multipliers and availability for each side, stable market ids through line moves, alternate rungs, recorded line history, changes, graded results and coverage/status endpoints.

### How do I use it from Claude or another AI agent?

Connect the MCP server at https://underdogapi.com/api/mcp with a bearer key, or call the REST API. Agents can request a key for their user with POST /api/v1/agent/signup.

### How much does it cost after the free tier?

Developer is $49/month for 10,000 credits, Production $149/month for 50,000, Scale $499/month for 250,000. Errors and unchanged 304 responses cost zero credits.

### How fresh is the data?

Each row carries its observation time. Check /api/v1/status and /api/v1/coverage before relying on a sport or window; missing collection is reported as unavailable, never filled in.

### Does it place entries or give picks?

No. It is data only: no entries, account operations, guaranteed outcomes or betting advice.

---
Independent data service, not affiliated with Underdog Fantasy or Underdog Sports. Docs: https://underdogapi.com/docs · OpenAPI: https://underdogapi.com/openapi.json · llms.txt: https://underdogapi.com/llms.txt
