# Underdog line history, as a CSV you can open.

> Download a free day of Underdog line history as CSV: new, moved, pulled and restored lines with timestamps, plus a coverage calendar. 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/data/history-sample

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

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

Dataset



One full day of recorded board changes for a league: every new offer, line move, pull and restore, timestamped. Recording begins with the first retained observation.

[Download NBA sample · Nov 14, 2026](https://underdogapi.com/data/history-sample/sample.csv?league=NBA) [Change feed reference](https://underdogapi.com/docs#changes)

Sample day (US Eastern) **Nov 14, 2026**

NBA events that day **24,429**

Line moves **1,422**

Leagues recorded **18**

| Time (UTC) | Player | Market | Previous | Line | Move |
| --- | --- | --- | --- | --- | --- |
| 05:19 | Michael Porter Jr. | points | 20.5 | 21.5 | +1 |
| 05:19 | Ty Jerome | steals | 1.5 | 0.5 | -1 |
| 05:30 | Julius Randle | points | 18.5 | 21.5 | +3 |
| 05:30 | Julius Randle | rebounds | 5.5 | 6.5 | +1 |
| 05:30 | Julius Randle | pts_rebs | 24.5 | 27.5 | +3 |
| 05:34 | Julius Randle | pts_rebs_asts | 30.5 | 32.5 | +2 |
| 05:34 | Julius Randle | pts_asts | 23.5 | 26.5 | +3 |
| 05:34 | Michael Porter Jr. | pts_rebs_asts | 29.5 | 32.5 | +3 |

First line moves in the file. Generated Nov 15, 23:03 UTC, cached for an hour.

## Other leagues

The latest completed day for each league with recorded changes.

[NBANov 14, 2026](https://underdogapi.com/data/history-sample/sample.csv?league=NBA) [NFLNov 14, 2026](https://underdogapi.com/data/history-sample/sample.csv?league=NFL) [CFBNov 14, 2026](https://underdogapi.com/data/history-sample/sample.csv?league=CFB) [NHLNov 14, 2026](https://underdogapi.com/data/history-sample/sample.csv?league=NHL) [FIFANov 8, 2026](https://underdogapi.com/data/history-sample/sample.csv?league=FIFA) [TENNISNov 14, 2026](https://underdogapi.com/data/history-sample/sample.csv?league=TENNIS) [CBBNov 14, 2026](https://underdogapi.com/data/history-sample/sample.csv?league=CBB) [CSNov 14, 2026](https://underdogapi.com/data/history-sample/sample.csv?league=CS) [DOTANov 14, 2026](https://underdogapi.com/data/history-sample/sample.csv?league=DOTA) [MMANov 14, 2026](https://underdogapi.com/data/history-sample/sample.csv?league=MMA) [PGANov 13, 2026](https://underdogapi.com/data/history-sample/sample.csv?league=PGA) [INTLBASKETBALLNov 13, 2026](https://underdogapi.com/data/history-sample/sample.csv?league=INTLBASKETBALL) [LOLNov 14, 2026](https://underdogapi.com/data/history-sample/sample.csv?league=LOL) [MOTORSPORTSNov 8, 2026](https://underdogapi.com/data/history-sample/sample.csv?league=MOTORSPORTS) [CFLNov 11, 2026](https://underdogapi.com/data/history-sample/sample.csv?league=CFL) [BKFCNov 7, 2026](https://underdogapi.com/data/history-sample/sample.csv?league=BKFC) [KBONov 8, 2026](https://underdogapi.com/data/history-sample/sample.csv?league=KBO) [OUTLAWSNov 7, 2026](https://underdogapi.com/data/history-sample/sample.csv?league=OUTLAWS)

## Coverage calendar

Recorded change events per league per US Eastern day, with board refreshes per day. Empty cells with refreshes are quiet boards; days with no refreshes are recording gaps.

| League | 06 | 07 | 08 | 09 | 10 | 11 | 12 | 13 | 14 | 15 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| NBA |  |  |  |  |  |  |  |  |  |  |
| NFL |  |  |  |  |  |  |  |  |  |  |
| CFB |  |  |  |  |  |  |  |  |  |  |
| NHL |  |  |  |  |  |  |  |  |  |  |
| FIFA |  |  |  |  |  |  |  |  |  |  |
| TENNIS |  |  |  |  |  |  |  |  |  |  |
| CBB |  |  |  |  |  |  |  |  |  |  |
| CS |  |  |  |  |  |  |  |  |  |  |
| DOTA |  |  |  |  |  |  |  |  |  |  |
| MMA |  |  |  |  |  |  |  |  |  |  |
| PGA |  |  |  |  |  |  |  |  |  |  |
| INTLBASKETBALL |  |  |  |  |  |  |  |  |  |  |
| LOL |  |  |  |  |  |  |  |  |  |  |
| MOTORSPORTS |  |  |  |  |  |  |  |  |  |  |
| CFL |  |  |  |  |  |  |  |  |  |  |
| BKFC |  |  |  |  |  |  |  |  |  |  |
| KBO |  |  |  |  |  |  |  |  |  |  |
| OUTLAWS |  |  |  |  |  |  |  |  |  |  |
| Refreshes | 194 | 1399 | 1841 | 1506 | 1135 | 338 | 1172 | 1234 | 1672 | 953 |

fewer eventsmore eventsrecording gaptoday, in progress Last 35 days shown. Hover a cell for counts.

## Columns

| Column | Meaning |
| --- | --- |
| change_id | Sequence id of the event. Same value as id and cursor in GET /api/v1/changes. |
| observed_at | UTC time the change was recorded (ISO 8601). |
| league | League code as used by the API. |
| event_type | line.opened, line.moved, line.closed or line.restored. |
| projection_id | Stable projection id. Use it with GET /api/v1/projections/{id}/history. |
| player | Player name as shown on the board. |
| team | Team abbreviation from the latest stored projection. |
| stat | Market name, for example Points or Pts+Rebs+Asts. |
| period | Market period, for example Full game. |
| higher_tier | Price class of Higher from the recorded event when present, not a current price applied to old history. |
| previous_line | Line before this event. Empty for line.opened. |
| line | Line after this event. |
| line_delta | line minus previous_line when both are numbers, else empty. |

RFC 4180 CSV, UTF-8, CRLF line endings. Text that a spreadsheet would run as a formula is prefixed with a single quote. Response headers carry `X-Sample-Date`, `X-Row-Count` and `X-Truncated`.

## Load it

Python · pandas

```
import pandas as pd

url = "https://underdogapi.com/data/history-sample/sample.csv?league=NBA"
df = pd.read_csv(url, parse_dates=["observed_at"])

moves = df[(df.event_type == "line.moved") & df.line_delta.notna() & (df.line_delta != 0)]
print(moves.groupby("stat").line_delta.describe())

# Biggest movers of the day
print(moves.reindex(moves.line_delta.abs().sort_values(ascending=False).index)
      .head(10)[["observed_at", "player", "stat", "previous_line", "line"]])
```

Node.js · the same day from the API

```
// Same events, any day since recording began. Node 18+.
const KEY = process.env.UNDERDOG_API_KEY;
let cursor = "0";
for (;;) {
  const url = new URL("https://underdogapi.com/api/v1/changes");
  url.search = new URLSearchParams({ league: "NBA", after: cursor, limit: "200" });
  const res = await fetch(url, { headers: { Authorization: `Bearer ${KEY}` } });
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  const { data, meta } = await res.json();
  for (const e of data) console.log(e.observed_at, e.type, e.player_name, e.previous_line, "->", e.line);
  if (!meta.next_cursor) break;
  cursor = meta.next_cursor;
  await new Promise((r) => setTimeout(r, 6100)); // stay under the Free per-minute limit
}
```

## Questions

How far back does recorded Underdog history go?

History exists from the first time this service observed an offer; nobody can backfill lines that were not recorded at the time. The calendar on this page shows every recorded day by league.

What is in the CSV sample?

Every change event recorded for one league on the most recent completed US Eastern day: new offers, line moves, offers taken down and offers restored, each with its UTC timestamp, previous and new line. It is the same data as GET /api/v1/changes, flattened to one row per event.

Can I download other days or leagues?

The free sample covers the latest completed day per league. Any day since recording began is available through GET /api/v1/changes and GET /api/v1/projections/{id}/history on Developer, Production and Scale. The Free plan reads the last 24 hours.

Does a day with no events mean data is missing?

Not always. The calendar shows board refreshes per day next to each league. Refreshes with no events mean the league had no board that day; no refreshes means that day is a recording gap.

## Keep going

[Guide **Underdog historical data** *History semantics, as-of queries and backtests.*](https://underdogapi.com/underdog-historical-data) [Endpoint **GET /api/v1/changes** *Every event since recording began.*](https://underdogapi.com/docs#changes) [Endpoint **GET /api/v1/projections/{id}/history** *Every version of one offer.*](https://underdogapi.com/docs#history) [Data **Graded NBA examples** *Over, under, push and void rows joined to final box scores.*](https://underdogapi.com/data/graded-examples) [Code **Line-change stream consumers** *Python and Node SSE clients with Last-Event-ID resume.*](https://underdogapi.com/tools/alert-consumer) [Pricing **Plans and request limits** *Free 100 credits a month. Paid plans from $49.*](https://underdogapi.com/pricing)

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

## References

- [API reference: change feed](https://underdogapi.com/docs#changes)
- [API reference: projection history](https://underdogapi.com/docs#history)
- [RFC 4180: CSV format](https://www.rfc-editor.org/rfc/rfc4180)

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