# Underdog data questions

> Direct answers to common Underdog data questions: API access, historical lines, payout multipliers, hit rates and prop models. Written by Stunning Couches LLC 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/questions

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

Answers from Stunning Couches LLC



Direct answers to what developers and modelers search for, written by the team behind this API and backed by our own recorded data.

## Access

### [Is there an independent Underdog Fantasy data API?](https://underdogapi.com/questions/is-there-an-underdog-fantasy-api)

Yes. This independent service exposes recorded Higher/Lower lines through REST and MCP.

### [Is the demo real player data?](https://underdogapi.com/questions/is-underdog-demo-data-real)

No. The keyless demo uses fictional players and explicitly labelled fixtures.

### [How should I store an API key?](https://underdogapi.com/questions/how-do-i-keep-my-underdog-api-key-safe)

Keep the key in your server environment or a backend secret store.

### [What happens at the monthly limit?](https://underdogapi.com/questions/what-happens-at-monthly-credit-limit)

The API returns a quota error with the applicable reset and upgrade information.

### [Is this service affiliated with Underdog?](https://underdogapi.com/questions/is-underdog-api-affiliated)

No. Underdog API is an independent developer data service.

### [Is there a free Underdog Fantasy API key?](https://underdogapi.com/questions/is-there-a-free-underdog-fantasy-api)

Yes. A free Underdog API key needs no card and includes 100 credits a month on the live board.

### [How do I get Underdog pick'em lines data?](https://underdogapi.com/questions/how-to-get-underdog-pickem-lines-data)

Call GET /api/v1/projections with a free key, filtered by sport, for the current Higher/Lower board.

### [Is there an Underdog Fantasy projections API?](https://underdogapi.com/questions/is-there-an-underdog-fantasy-projections-api)

Yes. This independent API returns the current Underdog Fantasy projections as JSON, CSV and MCP tool results.

### [Should I collect Underdog Fantasy lines myself?](https://underdogapi.com/questions/should-i-collect-underdog-lines-myself)

A script you run yourself only sees the board at the moment it runs, so history exists only if it keeps running and stores every result.

## Lines and history

### [What are alternate lines?](https://underdogapi.com/questions/underdog-alternate-lines-explained)

Alternates are different line rungs for the same stable market.

### [How often do Underdog lines move?](https://underdogapi.com/questions/how-often-do-underdog-lines-move)

Movement frequency must be measured over a stated window of retained observations.

### [How far back does recorded history go?](https://underdogapi.com/questions/how-far-back-does-underdog-history-go)

Only as far as the first retained observation for the relevant market or sport.

### [How do I check freshness?](https://underdogapi.com/questions/how-do-i-check-underdog-api-freshness)

Read source_status, observation time and the source update time when supplied.

### [Does repricing mean the line moved?](https://underdogapi.com/questions/does-a-price-change-mean-line-moved)

No. A price-only change can leave the numeric line unchanged.

### [Can I backfill unrecorded old lines?](https://underdogapi.com/questions/can-i-backfill-unrecorded-underdog-lines)

A current board cannot reconstruct lines and prices that were never observed.

### [Is there an Underdog Fantasy player props API?](https://underdogapi.com/questions/is-there-an-underdog-player-props-api)

Yes. Player props on the Underdog board are returned per league, player and stat, with each side priced separately.

### [What sports does the Underdog API cover?](https://underdogapi.com/questions/what-sports-does-the-underdog-api-cover)

Every league with lines on the Underdog board while collection observes it, including NBA, NFL, NHL and college sports.

### [When do Underdog lines come out?](https://underdogapi.com/questions/when-do-underdog-lines-come-out)

Measured from the first time a line appeared to the start, the median NHL line was up 19.8 hours ahead and the median NBA line 19.6 hours ahead.

### [When do NFL Underdog lines move?](https://underdogapi.com/questions/when-do-nfl-underdog-lines-move)

Most NFL line moves we recorded happened early: 55.8% more than 24 hours before kickoff and 21.9% between 6 and 24 hours before it.

### [Does Underdog have NHL player props?](https://underdogapi.com/questions/does-underdog-have-nhl-props)

Yes. NHL player props such as shots, points, goals, assists, saves and faceoffs won are on the board most game days, each side priced separately.

### [Does Underdog have college football props?](https://underdogapi.com/questions/does-underdog-have-college-football-props)

Yes. College football player props, such as passing, rushing and receiving yards, are on the board through the season with each side priced.

### [Does Underdog have college basketball props?](https://underdogapi.com/questions/does-underdog-have-college-basketball-props)

Yes. College basketball player props such as points, rebounds, assists and their combinations appear on the board during the season.

### [Does Underdog have esports props?](https://underdogapi.com/questions/does-underdog-have-esports-props)

Yes. Counter-Strike, Dota 2 and League of Legends player props such as kills appear on the board when matches are scheduled.

### [Does Underdog have tennis props?](https://underdogapi.com/questions/does-underdog-have-tennis-props)

Yes. Tennis props such as games won, aces and double faults are on the board for scheduled matches, each side priced separately.

## Side prices

### [What is an Underdog payout multiplier?](https://underdogapi.com/questions/what-is-an-underdog-payout-multiplier)

A selection’s multiplier adjusts its contribution to an entry payout.

### [Why do some lines have no Lower side?](https://underdogapi.com/questions/why-do-some-underdog-lines-have-no-lower)

The observed market may offer only Higher.

### [Where can I get Underdog payout multiplier data?](https://underdogapi.com/questions/where-to-get-underdog-payout-multiplier-data)

GET /api/v1/multipliers returns the boosted and discounted sides on the current board, each with its own multiplier.

### [How often do Underdog boosted picks hit?](https://underdogapi.com/questions/how-often-do-underdog-boosted-picks-hit)

In graded games from 2026-11-06 to 2026-11-13, Higher sides priced above 1.0x hit 32.6% of the time (1,907 of 5,844).

### [How often do Underdog discounted picks hit?](https://underdogapi.com/questions/how-often-do-underdog-discounted-picks-hit)

In graded games from 2026-11-06 to 2026-11-13, Higher sides priced below 1.0x hit 55.9% of the time (1,221 of 2,185).

### [What are Underdog boosted and discounted picks?](https://underdogapi.com/questions/what-are-underdog-boosted-and-discounted-picks)

Underdog prices each Higher and Lower side with its own payout multiplier: above 1.0x is boosted, below 1.0x is discounted, 1.0x is standard.

### [Do boosted or discounted Underdog picks hit more often?](https://underdogapi.com/questions/do-boosted-or-discounted-underdog-picks-hit-more)

Discounted sides hit more often: in graded games from 6 to 11 November 2026, discounted Higher sides hit 55.8% against 32.5% for boosted Higher sides.

### [How often do Higher-only Underdog lines hit?](https://underdogapi.com/questions/how-often-do-higher-only-underdog-lines-hit)

Lines offered with no Lower side hit Higher 36.4% of the time (849 of 2,333) in graded games from 6 to 11 November 2026.

## Results and payouts

### [How do Standard, Flex and Streaks differ?](https://underdogapi.com/questions/underdog-standard-vs-flex-payouts)

They are distinct entry formats with different payout and settlement rules.

### [What does a break-even rate mean?](https://underdogapi.com/questions/what-is-the-underdog-break-even-rate)

It is a mathematical threshold under stated payout and probability assumptions.

### [Does a tie void?](https://underdogapi.com/questions/does-underdog-void-ties)

The Underdog grading contract treats a tie to the line as void.

### [How are non-starting players graded?](https://underdogapi.com/questions/how-underdog-voids-players-who-do-not-start)

Non-starter rules depend on sport, market and recorded participation.

### [Does current coverage mean grading exists?](https://underdogapi.com/questions/does-current-coverage-mean-grading)

No. Board collection and result grading are separate coverage dimensions.

### [Does a hit rate predict a winning entry?](https://underdogapi.com/questions/can-a-hit-rate-predict-a-winning-entry)

No. A retained hit rate describes a selected historical sample.

### [What is the Underdog Higher hit rate?](https://underdogapi.com/questions/what-is-the-underdog-higher-hit-rate)

Across 11,274 graded lines, Higher hit 42.1% and Lower hit 57.9%.

### [How do Underdog multipliers change my entry payout?](https://underdogapi.com/questions/how-do-underdog-multipliers-change-my-payout)

The base table for the entry size is multiplied by the multipliers of the winning picks, so a 1.2x pick raises the payout and a 0.8x pick lowers it.

### [What are Underdog pick'em payouts by entry size?](https://underdogapi.com/questions/what-are-underdog-pickem-payouts-by-entry-size)

At 1.0x picks, Standard entries pay 3.5x for 2 picks, 6.5x for 3, 12x for 4, 20x for 5, 35x for 6, 65x for 7 and 120x for 8.

### [Which Underdog entry has the lowest break-even rate?](https://underdogapi.com/questions/which-underdog-entry-has-the-lowest-break-even)

On the published base table at 1.0x, the 2-pick Standard entry has the lowest break-even: 53.45% per pick, then 3-pick Standard at 53.58%.

### [How do Underdog Ladders payouts work?](https://underdogapi.com/questions/how-do-underdog-ladders-payouts-work)

Ladders pays by the lowest rung every pick reached: three picks pay 1.5x, 3x or 100x, four pay 2x, 5x or 500x, five pay 2.5x, 10x or 1,000x.

## Building

### [Can I use the API with Python?](https://underdogapi.com/questions/can-i-use-underdog-api-with-python)

Yes. A server-side Python client can call the documented REST endpoints.

### [Can I use the API with JavaScript?](https://underdogapi.com/questions/can-i-use-underdog-api-with-javascript)

Yes. Use fetch from a server or a backend function that keeps your key private.

### [How do I paginate the board?](https://underdogapi.com/questions/how-do-i-paginate-underdog-lines)

Pass the returned next cursor with the same filters on the next request.

### [Can I export lines to CSV?](https://underdogapi.com/questions/can-i-export-underdog-lines-to-csv)

Yes. The export endpoint provides bounded observations in CSV form.

### [Can I receive signed webhooks?](https://underdogapi.com/questions/does-underdog-api-send-webhooks)

Production and Scale support signed change delivery to a registered endpoint.

### [How do I resume a change stream?](https://underdogapi.com/questions/how-do-i-resume-underdog-stream)

Persist the last processed event id and send it when reconnecting.

### [Can final minutes be a pre-game feature?](https://underdogapi.com/questions/can-i-train-on-final-minutes)

No. Realized minutes and final outcomes are post-game labels.

### [How do I use Underdog data in ChatGPT or Claude?](https://underdogapi.com/questions/how-to-use-underdog-data-in-chatgpt-or-claude)

Connect the MCP server at https://underdogapi.com/api/mcp; Claude clients send your key as a bearer header.

### [How do I build an NBA prop model with Underdog data?](https://underdogapi.com/questions/how-to-build-an-nba-prop-model-with-underdog-data)

Use GET /api/v1/training-set for graded NBA lines with opening and closing lines and outcomes, and /api/v1/game-logs for earlier player games.

### [How do I build an NFL prop model with Underdog data?](https://underdogapi.com/questions/how-to-build-an-nfl-prop-model-with-underdog-data)

Start from graded NFL lines in GET /api/v1/training-set and add earlier games from /api/v1/game-logs, with features fixed at decision time.

### [How do I backtest Underdog picks?](https://underdogapi.com/questions/how-to-backtest-underdog-picks)

Read the board as it stood at a past time with GET /api/v1/board?as_of=..., then grade those picks against GET /api/v1/results.

### [How do I avoid data leakage in an Underdog backtest?](https://underdogapi.com/questions/how-to-avoid-data-leakage-in-an-underdog-backtest)

Fix a decision time and use only lines and stats recorded before it; a later closing line or same-game box score must not reach a feature.

### [Can I train a prop model with a free Underdog API key?](https://underdogapi.com/questions/can-i-train-a-prop-model-with-a-free-underdog-key)

Not a full model: on Free, GET /api/v1/training-set answers 402 with a few labelled sample rows at no credit cost, enough to test parsing.

Independent data service, not affiliated with Underdog. Information only, not betting advice. Looking for depth? See the [developer guides](https://underdogapi.com/resources) and the [API docs](https://underdogapi.com/docs).

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