# How are non-starting players graded?

> Non-starter rules depend on sport, market and recorded participation. A missing box-score player is not automatically a zero. Unsupported or unverified rules… 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/how-underdog-voids-players-who-do-not-start

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

## SDKs and packages

Official clients for Underdog API (independent; not Underdog Fantasy). Source: https://github.com/underdogapi · Overview: https://underdogapi.com/sdks

- Python SDK: `pip install underdog-api` (PyPI: https://pypi.org/project/underdog-api/ · source: https://github.com/underdogapi/underdogapi-python)
- JavaScript / TypeScript SDK: `npm install underdog-api` (npm: https://www.npmjs.com/package/underdog-api · source: https://github.com/underdogapi/underdogapi-js)
- MCP server (stdio): `npx -y underdog-api-mcp` (npm: https://www.npmjs.com/package/underdog-api-mcp · source: https://github.com/underdogapi/underdogapi-mcp)

Python:

```python
from underdog_api import Client

ud = Client()  # reads UNDERDOG_API_KEY
board = ud.projections(league="NBA", view="compact", limit=20)
for line in board["data"]:
    print(line)
print(board["meta"]["observed_at"])
```

Claude Code with the stdio MCP package (the hosted server at /api/mcp needs no install):

```bash
claude mcp add underdog -e UNDERDOG_API_KEY=ud_... -- npx -y underdog-api-mcp
```

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

Answer from Stunning Couches LLC



Non-starter rules depend on sport, market and recorded participation. A missing box-score player is not automatically a zero. Unsupported or unverified rules remain ungraded with a reason.

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

| Format | Entry | Base payouts | Base break-even |
| --- | --- | --- | --- |
| standard | 2 picks | 2/2: 3.5x | 53.5% |
| standard | 3 picks | 3/3: 6.5x | 53.6% |
| standard | 4 picks | 4/4: 12x | 53.7% |
| standard | 5 picks | 5/5: 20x | 54.9% |
| standard | 6 picks | 6/6: 35x | 55.3% |
| standard | 7 picks | 7/7: 65x | 55.1% |
| standard | 8 picks | 8/8: 120x | 55.0% |
| flex | 3 picks | 2/3: 1.09x · 3/3: 3.25x | 55.4% |
| flex | 4 picks | 3/4: 1.4x · 4/4: 6x | 55.6% |
| flex | 5 picks | 4/5: 2.5x · 5/5: 10x | 54.7% |
| flex | 6 picks | 4/6: 0.25x · 5/6: 2.6x · 6/6: 25x | 53.8% |
| flex | 7 picks | 5/7: 0.5x · 6/7: 2.75x · 7/7: 40x | 55.4% |
| flex | 8 picks | 6/8: 1x · 7/8: 3x · 8/8: 80x | 55.1% |
| streaks | 2 picks | 2/2: 3x | 57.7% |
| streaks | 3 picks | 3/3: 6x | 55.0% |
| streaks | 4 picks | 4/4: 10x | 56.2% |
| streaks | 5 picks | 5/5: 20x | 54.9% |
| streaks | 6 picks | 6/6: 35x | 55.3% |
| streaks | 7 picks | 7/7: 65x | 55.1% |
| streaks | 8 picks | 8/8: 120x | 55.0% |
| streaks | 9 picks | 9/9: 225x | 54.8% |
| streaks | 10 picks | 10/10: 425x | 54.6% |
| streaks | 11 picks | 11/11: 1000x | 53.4% |

Reference at 1.0x, assuming independent picks with equal probability. Actual side multipliers and correlation affect the quoted entry. [Payout explorer](https://underdogapi.com/tools/line-explorer)

A missing box-score player is not automatically a zero. Unsupported or unverified rules remain ungraded with a reason.

Inspect source status and observation timestamps before relying on a row. Fictional demo responses are explicitly labelled and are separate from retained observations.

## Go further

[**Read the API reference**](https://underdogapi.com/docs#results) [**Schema glossary**](https://underdogapi.com/docs/schema-glossary)

## Related questions

[**How do Standard, Flex and Streaks differ?**](https://underdogapi.com/questions/underdog-standard-vs-flex-payouts) [**What does a break-even rate mean?**](https://underdogapi.com/questions/what-is-the-underdog-break-even-rate) [**Does a tie void?**](https://underdogapi.com/questions/does-underdog-void-ties) [**Does current coverage mean grading exists?**](https://underdogapi.com/questions/does-current-coverage-mean-grading)

[All questions](https://underdogapi.com/questions)

Independent data service, not affiliated with Underdog. Information only, not betting advice.

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