# FanDuel line move Discord bot in Python

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-discord-bot (this is its markdown version, https://fanduelapi.com/fanduel-discord-bot.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/)/ Discord bot

Discord bot

# A FanDuel line move bot for Discord

About sixty lines of Python that watch the FanDuel change feed and post every prop line move of a set size to a Discord channel through a channel webhook. It saves its place, so a restart neither misses moves nor posts them twice.

[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.

## The bot

bot.py

```
"""Post FanDuel prop line moves to Discord. pip install requests; python bot.py"""
import json, os, time
import requests

API = "https://fanduelapi.com/api/v1"
KEY = os.environ["FANDUEL_API_KEY"]
DISCORD = os.environ["DISCORD_WEBHOOK_URL"]   # Channel settings, Integrations, Webhooks
LEAGUES = "NBA,NFL"
MIN_MOVE = 1.0                                  # post line moves of at least one unit
POLL_SECONDS = 3000
STATE = "cursor.json"

def load_cursors():
    try:
        return json.load(open(STATE))
    except (OSError, ValueError):
        return {}      # first run: each league starts from this moment, no backlog

def changes(cursor, league):
    r = requests.get(f"{API}/changes", params={"since": cursor, "league": league, "limit": 500},
                     headers={"Authorization": f"Bearer {KEY}"}, timeout=20)
    if r.status_code == 429:
        time.sleep(int(r.headers.get("Retry-After", "30")))
        return [], cursor
    r.raise_for_status()
    body = r.json()
    return body["data"], body["meta"]["next_cursor"]

def post(lines):
    for i in range(0, len(lines), 15):      # stay well under Discord's 2,000 characters a message
        requests.post(DISCORD, json={"content": "\n".join(lines[i:i + 15])}, timeout=10).raise_for_status()
        time.sleep(1)

saved = load_cursors()
cursors = {league: saved.get(league, "now") for league in LEAGUES.split(",")}
while True:
    for league, cursor in cursors.items():
        rows, cursors[league] = changes(cursor, league)
        moves = [c for c in rows if c["kind"] == "line_move" and c["previous"]
                 and c["previous"]["line"] is not None and c["current"]["line"] is not None
                 and abs(c["current"]["line"] - c["previous"]["line"]) >= MIN_MOVE]
        if moves:
            post([f"**{c['player']}** {c['stat']} ({league}): {c['previous']['line']} to {c['current']['line']}, "
                  f"over {c['current']['over_american']}" for c in moves])
    json.dump(cursors, open(STATE, "w"))
    time.sleep(POLL_SECONDS)
```

Set `FANDUEL_API_KEY` and `DISCORD_WEBHOOK_URL`, then run it on any machine that stays up. The interval is set for two leagues on Developer. On Free, 100 credits a month on data five minutes behind is enough to try it for a day, not to run it.

## How it works

- **Change feed with a cursor.** Each call returns only what changed since the last cursor, so a quiet slate costs one small call. Pagination details are on [pagination](https://fanduelapi.com/fanduel-api-pagination).
- **Line moves only.** Price-only moves, suspensions and new props are in the feed too; change the filter on `c["kind"]` to post them.
- **One cursor per league.** The league filter keeps each call small; each league's cursor is saved after every pass, so the bot resumes each one exactly where it stopped.

## Without polling

For alerts the moment a line moves, keep a connection on the [live stream](https://fanduelapi.com/fanduel-api-websocket), or on Production let [webhooks](https://fanduelapi.com/fanduel-api-webhooks) call a small function that forwards each batch to Discord. What the move fields mean is on [line movement](https://fanduelapi.com/fanduel-line-movement); the request helper used here is explained on the [Python page](https://fanduelapi.com/fanduel-api-python).

## Questions

## Related

- [Webhooks Register a webhook for FanDuel line and price changes, verify the HMAC signature in Python or Node, read the payload and recover a missed batch.](https://fanduelapi.com/fanduel-api-webhooks)
- [Live stream There is no WebSocket here: FanDuel line changes stream over Server-Sent Events with resume. The event types, Python and Node clients, and the limits.](https://fanduelapi.com/fanduel-api-websocket)
- [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)
- [Python example Working Python code for FanDuel Sportsbook player props: authenticate with a key, list props, read a prop's move history and poll for changes.](https://fanduelapi.com/fanduel-api-python)
- [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.