# Read the observed board with separate higher and lower prices.

> Filter by sport, stat slug, player/team search and per-side payout tier. 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/products/projections

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

Current lines



Filter by sport, stat slug, player/team search and per-side payout tier.

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

Current lines

## Read the observed board with separate higher and lower prices.

1. 1Inspect coverage
2. 2Read a bounded page
3. 3Keep timestamps and cursors

GET `/api/v1/projections`

Illustrative request; replace any fixture id or player name with one returned by the API.

```
curl 'https://underdogapi.com/api/v1/projections?sport=NBA&stat=points&view=compact&limit=25' \
  -H "Authorization: Bearer $UNDERDOG_API_KEY" \
  -H 'X-User-Request: Inspect recorded Underdog data for a research tool'
```

Illustrative response shape 200 OK

```
{
  "data": [
    {
      "id": "udm_00000000-0000-4000-8000-000000000001",
      "line_id": "udl_00000000-0000-4000-8000-000000000001",
      "source_projection_id": "udm_00000000-0000-4000-8000-000000000001",
      "source": "demo",
      "market_id": "udm_00000000-0000-4000-8000-000000000001",
      "category": "player_prop",
      "non_discounted_line": null,
      "is_discounted": false,
      "has_alternates": false,
      "boost": null,
      "lineup_status": null,
      "home_away": null,
      "sport": "NBA",
      "league": "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,
      "line_type": "balanced",
      "higher_only": true,
      "prediction_market": false,
      "selections": [
        {
          "side": "higher",
          "multiplier_scale": "legacy_1x",
          "available": true,
          "payout_multiplier": 1,
          "payout_tier": "standard",
          "tier": "standard",
          "american_price": -110,
          "decimal_price": 1.9,
          "fantasy_odds": {
            "american": null,
            "decimal": 1.87,
            "probability": null
          }
        },
        {
          "side": "lower",
          "multiplier_scale": "legacy_1x",
          "available": false,
          "payout_multiplier": null,
          "payout_tier": null,
          "tier": "unknown",
          "american_price": null,
          "decimal_price": null,
          "fantasy_odds": null
        }
      ],
      "status": "active",
      "observed_at": "2026-10-27T18:30:00.000Z",
      "source_updated_at": "2026-10-27T18:30:00.000Z",
      "source_board_time": null,
      "first_seen_at": "2026-10-27T18:30:00.000Z",
      "last_seen_at": "2026-10-27T18:30:00.000Z",
      "is_demo": true
    }
  ],
  "meta": {
    "mode": "demo",
    "schema_version": "1.0",
    "count": 1,
    "limit": 1,
    "next_cursor": null,
    "observed_at": "2026-10-27T18:30:00.000Z",
    "source_status": "demo",
    "notice": "Fictional sample data. Not live Underdog lines.",
    "is_demo": true
  }
}
```

## A five-row request, then a deliberate next page

Send Authorization and X-User-Request, a non-sensitive job purpose retained for 35 days. This five-row full response costs 3 credits on credits_v1; compact responses cost 1 credit per requested 100 rows. Inspect X-Credits-Cost and meta.next_cursor before continuing.

Use market.period, selection availability and observation timestamps. Unknown values stay unknown. An empty or stale response is not proof of complete live coverage.

[Python quickstart](https://underdogapi.com/underdog-api-python) · [Download the starter kit](https://underdogapi.com/developers/starter-kit) · [Measured coverage](https://underdogapi.com/history-coverage) · [Compare matched prices](https://underdogapi.com/docs/league-workflows)

### Documented contract

Filter by sport, stat slug, player/team search and per-side payout tier.

### Actual observations

History starts with the first recorded observation. Demo rows are explicitly fictional and never substitute for live data.

### Bounded access

Inspect plan_limit and credit usage. An upgrade cannot create missing markets or unrecorded dates.

## Works well with

[Implementation guide](https://underdogapi.com/docs)

[### Line history Read the recorded changes of one stable market. `GET /api/v1/projections/udm_00000000-0000-4000-8000-000000000001/history`](https://underdogapi.com/products/line-history) [### Side multipliers Find recorded boosted and discounted sides. `GET /api/v1/multipliers`](https://underdogapi.com/products/multipliers) [### Coverage and freshness Check observed sports, stat slugs, counts and recording bounds. `GET /api/v1/coverage`](https://underdogapi.com/products/coverage)

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