# Underdog Fantasy projections API

> Underdog Fantasy projections API reference: parameters, every response field, example JSON, credit cost and the related history, alternates, changes and stream endpoints. 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/underdog-projections-api

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

Endpoint · updated November 13, 2026



Short answer: The Underdog Fantasy projections API is GET https://underdogapi.com/api/v1/projections: it returns every current Underdog pick'em line as JSON (player, stat, period, line and separate Higher and Lower payout multipliers), filterable by sport, stat, player and payout tier, with a free key of 100 credits a month.

## Facts

| Method and URL | GET https://underdogapi.com/api/v1/projections |
| --- | --- |
| Auth | Authorization: Bearer <key> |
| Returns | data[]: one row per current Underdog line; meta: count, next_cursor, observed_at, source_status |
| Page size | limit, default 50; up to 200 full rows or 1,000 compact rows |
| Credits | 3 per 100 full rows; 1 per 100 with view=compact; errors cost 0 |
| Freshness | Every row has observed_at; meta.source_status says fresh, stale, partial or failed |
| No-key demo | GET https://underdogapi.com/api/v1/demo/projections |
| Machine contract | https://underdogapi.com/openapi.json |

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

## Request

curl

```
curl "https://underdogapi.com/api/v1/projections?sport=NBA&stat=points&limit=50" \
  -H "Authorization: Bearer $UNDERDOG_API_KEY"
```

| Parameter | Type | Meaning |
| --- | --- | --- |
| sport | string | Uppercase sport code or comma list: NBA, NFL, CFB, CBB, NHL, MMA, TENNIS, CS, DOTA, LOL, CFL, INTLBASKETBALL. league is an alias. |
| stat | string | Exact machine stat slug, for example points, rebounds, pts_rebs_asts, passing_yds, rush_rec_yds |
| search | string | Player or team name search |
| payout_tier | standard \| boosted \| discounted | Only lines with a side at this tier |
| higher_only | boolean | Only lines where Higher is available and Lower is not |
| include_prediction | boolean | Include prediction contracts (excluded by default) |
| status | active \| unavailable \| all | Default active. Retained rows can be stale; read observed_at |
| start_after / start_before | ISO time | Event start window (inclusive / exclusive) |
| view | full \| compact | compact drops nested detail and allows 1,000 rows a page |
| limit, cursor | integer, string | Page size and the meta.next_cursor from the previous page |

## Response

Trimmed from the keyless demo; real rows carry more fields.

200 application/json

```
{
  "data": [{
    "id": "udm_00000000-0000-4000-8000-000000000001",
    "sport": "NBA",
    "player": { "id": "pl_demo_0", "name": "Jordan Ellis", "team": "BOS", "position": "G" },
    "event": { "id": "fx_demo_0", "opponent": "NYK", "starts_at": "2026-10-28T00:00:00.000Z" },
    "market": { "id": "udm_00000000-0000-4000-8000-000000000001", "stat": "points", "period": "Full game" },
    "line": 27.5,
    "selections": [
      { "side": "higher", "available": true,  "payout_multiplier": 1,    "payout_tier": "standard" },
      { "side": "lower",  "available": false, "payout_multiplier": null, "payout_tier": null }
    ],
    "observed_at": "2026-10-27T18:30:00.000Z"
  }],
  "meta": { "count": 1, "limit": 1, "next_cursor": "udm_...", "source_status": "fresh" }
}
```

| Field | Meaning |
| --- | --- |
| id, market_id, line_id | Stable market id (kept through line moves) and the id of this priced version of the line |
| sport, league | League code, for example NBA |
| player | id, name, team, position |
| event | id, opponent, starts_at |
| market | id, stat (machine slug), period (Full game, 1st quarter ...) |
| line | The number you pick Higher or Lower on |
| selections[] | One per side: side (higher or lower), available, payout_multiplier, payout_tier (standard, boosted, discounted), american_price, decimal_price |
| has_alternates | True when other rungs exist; read them from /projections/{id}/alternates |
| higher_only | Higher available, Lower not offered |
| observed_at, first_seen_at, last_seen_at | When we observed this row, first saw it and last saw it |

## Related endpoints

| Endpoint | What it returns |
| --- | --- |
| GET /api/v1/projections/{id}/history | [Every recorded line and multiplier change for one line](https://underdogapi.com/underdog-historical-data) |
| GET /api/v1/projections/{id}/alternates | [Alternate rungs with their own side prices](https://underdogapi.com/underdog-alternate-lines) |
| GET /api/v1/changes | [Ordered line.moved and line.repriced events across the board](https://underdogapi.com/underdog-line-movement-api) |
| GET /api/v1/multipliers | [Only boosted and discounted sides](https://underdogapi.com/underdog-payout-multipliers) |
| GET /api/v1/board | [The whole board at a past instant](https://underdogapi.com/docs) |
| GET /api/v1/results | [Lines graded against final box scores; ties void](https://underdogapi.com/data/graded-examples) |
| GET /api/v1/export | [One page as CSV or text](https://underdogapi.com/underdog-api-csv-export) |
| GET /api/v1/stream | [Server-sent events for every change](https://underdogapi.com/tools/alert-consumer) |

## Questions

Is there an Underdog Fantasy projections API?

Yes, from Underdog API: GET https://underdogapi.com/api/v1/projections returns the current Underdog pick'em board. Underdog Fantasy itself does not publish a public API.

Does it include the Higher and Lower multipliers?

Yes. Each row has a selections array with one entry per side, each with available, payout_multiplier and payout_tier. An unavailable side keeps a null multiplier rather than a made-up 1.0x.

Does a line keep its id when Underdog moves it?

Yes. id and market_id stay the same through numeric line moves; line_id changes with each priced version, so you can follow one line over time.

How do I filter one player or one stat?

Use search for the player or team and stat for the exact machine slug, for example ?sport=NBA&search=Tatum&stat=points.

[How-to **Get projections in Python or JS** *Copy-paste code.*](https://underdogapi.com/how-to-get-underdog-projections) [Overview **Underdog Fantasy API options** *Official, scrapers or hosted.*](https://underdogapi.com/underdog-fantasy-api) [Reference **Schema glossary** *Every field defined.*](https://underdogapi.com/docs/schema-glossary) [MCP **get_projections from an agent** *Claude, ChatGPT, Cursor.*](https://underdogapi.com/mcp)

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

- [Underdog API reference](https://underdogapi.com/docs)
- [OpenAPI contract](https://underdogapi.com/openapi.json)
- [Keyless demo response](https://underdogapi.com/api/v1/demo/projections?limit=1)

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