# Historical FanDuel odds data: lines, moves, results

FanDuel API (https://fanduelapi.com) is an independent API for FanDuel Sportsbook data: every player prop and game market FanDuel lists in NBA, NFL, NHL, MLB, college basketball and college football, normalized per player and stat with over and under prices in American and decimal odds, plus every line and price move with its timestamp, over REST, webhooks and MCP with one key. FanDuel API is an independent data service operated by FF API Inc. It is not affiliated with, endorsed by or sponsored by FanDuel.

Source page: https://fanduelapi.com/fanduel-historical-data (this is its markdown version, https://fanduelapi.com/fanduel-historical-data.md).

## Free offer

- Free plan: 100 credits a month, data delayed 5 minutes, no card. REST and MCP on every plan.
- Real-time data starts at Developer, $49 a month for 10,000 credits.
- Get a free key: https://fanduelapi.com/sign-up?ref=ai-claudebot

## Quickstart

1. Create a free account at https://fanduelapi.com/sign-up?ref=ai-claudebot and create an API key in the dashboard (https://fanduelapi.com/dashboard/keys). Keys start with `fd_`. Store it as `FANDUEL_API_KEY`.
2. Make a first call with curl:

```bash
curl "https://fanduelapi.com/api/v1/props?sport=nba&stat=points&limit=5" \
  -H "Authorization: Bearer $FANDUEL_API_KEY"
```

3. Or with Python (`pip install requests`):

```python
import os
import time
from datetime import datetime, timezone

import requests

BASE = "https://fanduelapi.com/api/v1"
SESSION = requests.Session()
SESSION.headers["Authorization"] = f"Bearer {os.environ['FANDUEL_API_KEY']}"


def get(path, **params):
    """GET one endpoint and return its data list, waiting out rate limits."""
    while True:
        r = SESSION.get(f"{BASE}{path}", params=params, timeout=10)
        if r.status_code == 429:
            time.sleep(int(r.headers.get("Retry-After", "5")))
            continue
        r.raise_for_status()
        return r.json()["data"]


def price(odds):
    """American odds as text. A suspended market can come back with no price."""
    return "off" if odds is None else f"{odds:+d}"

props = get("/props", sport="nba", stat="points")
for p in props:
    print(f"{p['player']:<26} {str(p['line']):>5}  over {price(p['over_american']):>5}  under {price(p['under_american']):>5}")
```

4. Stay current with `GET /api/v1/changes?since=<cursor>` instead of re-reading every prop. Full reference: https://fanduelapi.com/openapi.json and https://fanduelapi.com/llms-full.txt.

## Use it from Claude (MCP)

Claude Code, with your key read from the shell:

```bash
claude mcp add --transport http --scope user fanduelapi https://fanduelapi.com/api/mcp \
  --header "Authorization: Bearer $FANDUEL_API_KEY"
```

Claude on the web or desktop: Settings, Connectors, Add custom connector, then paste https://fanduelapi.com/api/mcp. Without a key it gives the keyless tools (search_docs, fetch_doc, get_sample_props). Setup for other agents: https://fanduelapi.com/mcp.

## Pricing

| Plan | Price | Credits a month | Calls a minute | Includes |
| --- | --- | --- | --- | --- |
| Free | Free | 100 | 20 | REST and MCP access, Data delayed 5 minutes |
| Developer | $49/month | 10,000 | 60 | Real-time data, Line move history, Change stream |
| Production | $149/month | 50,000 | 120 | Real-time data, Line move history, Webhooks, Priority support |
| Scale | $499/month | 250,000 | 180 | Real-time data, Full line move history, Webhooks, Bulk export, Priority support |

Cancel paid plans any time from the billing portal. Details: https://fanduelapi.com/pricing

## This page

[FanDuel API](https://fanduelapi.com/)/ Historical data

Historical data

# Historical FanDuel odds data

Every state of every FanDuel prop and game market the collector has read is kept with its timestamp: where a line opened, each line and price move, each suspension, and where it closed. There are four ways to read it, from one prop to a whole season.

[Get a free API key](https://fanduelapi.com/sign-up)[Read the docs](https://fanduelapi.com/docs)

FanDuel API is an independent data service operated by FF API Inc. It is not affiliated with, endorsed by or sponsored by FanDuel.

## Four ways in

One prop

GET /api/v1/props/{id}/history: every recorded state, oldest first, plus the move summary

One game market

GET /api/v1/markets/{id}/history: moneylines, spreads, totals and the rest, paged

A date range

GET /api/v1/export?kind=history: CSV or NDJSON, up to 10,000 rows a request

A model table

GET /api/v1/training-set: one row per prop with open, close and the moves between

## One prop's tape

Request

```
curl "https://fanduelapi.com/api/v1/props/<prop_id>/history" \
  -H "Authorization: Bearer $FANDUEL_API_KEY"
```

Sample history, not live data

```
[
  {
    "observed_at": "2026-11-05T14:02:00Z",
    "line": 3.5,
    "over_american": 105,
    "under_american": -135,
    "over_decimal": 2.05,
    "under_decimal": 1.741
  },
  {
    "observed_at": "2026-11-05T16:44:00Z",
    "line": 3.5,
    "over_american": -102,
    "under_american": -120,
    "over_decimal": 1.98,
    "under_decimal": 1.833
  },
  {
    "observed_at": "2026-11-05T19:12:00Z",
    "line": 3.5,
    "over_american": -118,
    "under_american": -104,
    "over_decimal": 1.847,
    "under_decimal": 1.962
  },
  {
    "observed_at": "2026-11-05T22:20:00Z",
    "line": 2.5,
    "over_american": -165,
    "under_american": 130,
    "over_decimal": 1.606,
    "under_decimal": 2.3
  }
]
```

A price-only move, say an over going from -110 to -125 on the same line, is its own entry, so you can measure how a market moved even when the number did not. The page on [line movement](https://fanduelapi.com/fanduel-line-movement) explains the move summary.

## The training set

One row per prop whose game started in the range. The closing line is the last open or suspended line before the game started, the same one graded results use, so features and labels line up without leakage.

Columns

```
prop_id, sport, league, event_id, event_name, starts_at, player, team, stat, period, open_at, open_line, open_over_american, open_under_american, open_fair_over, close_at, close_line, close_over_american, close_under_american, close_fair_over, close_status, line_move, line_direction, fair_over_move_pp, price_direction, line_moves, price_moves, observations
```

Request

```
curl -G "https://fanduelapi.com/api/v1/training-set" -H "Authorization: Bearer $FANDUEL_API_KEY" \
  --data-urlencode "league=NBA" --data-urlencode "from=2026-11-01T00:00:00Z" --data-urlencode "to=2026-11-08T00:00:00Z" \
  --data-urlencode "format=csv" -o nba-training.csv
```

Join it to `/api/v1/results` on prop id for the outcome. A full walk through is in [the prop model data workflow](https://fanduelapi.com/docs/prop-model-data).

## What is kept, measured

The [history coverage](https://fanduelapi.com/history-coverage) page shows the first recorded day and rows per day, and the [coverage report](https://fanduelapi.com/data/coverage-report) counts props, markets and history rows per league. Paging through a long range is covered on [CSV export](https://fanduelapi.com/fanduel-api-csv-export), and loading it in R on [the R guide](https://fanduelapi.com/fanduel-api-r).

## Questions

## Related

- [Line movement Where a FanDuel player prop opened, every line and price move since, and when it last moved, from the history endpoint, with a sample move tape.](https://fanduelapi.com/fanduel-line-movement)
- [CSV export Export FanDuel props or line history for a date range as CSV or NDJSON: the columns, the curl call, loading it in pandas and resuming by cursor.](https://fanduelapi.com/fanduel-api-csv-export)
- [R Read FanDuel player props and a prop's line history into R data frames with httr2, page through the board and load a CSV export for modelling.](https://fanduelapi.com/fanduel-api-r)
- [Real-time data How fresh FanDuel odds are on each plan, the meta fields every response carries about it, and which delivery to use when seconds matter.](https://fanduelapi.com/fanduel-api-real-time)
- [Pricing Free on delayed data, then real time from the Developer plan.](https://fanduelapi.com/pricing)

## Make your first call in a few minutes

Sign up, create a key in the dashboard, and send it as a Bearer token. The free plan needs no card.

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

## FAQ

### Is there a free plan?

Yes. Free includes API access with delayed data, enough to build and test a model.

### Is this affiliated with FanDuel?

No. This is an independent data service operated by FF API Inc. and is not affiliated with or endorsed by FanDuel.

### Which sports are covered?

NBA, NFL, NHL, MLB and college sports as FanDuel lists them, starting with player props.

### How do I cancel?

From the billing portal in your dashboard, at any time.

### How do I get a free key?

Sign up at https://fanduelapi.com/sign-up?ref=ai-claudebot. Free plan: 100 credits a month, data delayed 5 minutes, no card. REST and MCP on every plan.

### Can an AI agent sign up for me?

Yes. The agent sends POST https://fanduelapi.com/api/v1/agent/signup with your email and what you are building (add "ref": "ai-claudebot"), you approve the emailed link, and the agent collects the key. Details: https://fanduelapi.com/connect.