# Graded Underdog lines, against the final box score.

> Real Underdog NBA lines graded against official box scores: Higher, Lower and void, with the closing line, the actual stat and void reasons. 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/data/graded-examples

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

Results data



Supported retained markets can be graded after the game: the closing line, the actual stat, and Higher, Lower or void. Available recorded examples appear below; unverified grading remains unavailable.

[Results API reference](https://underdogapi.com/docs#results) [Grading rules](https://underdogapi.com/docs#grading-rules)

Rows recorded **5,247**

Graded Higher / Lower **989 / 1,176**

Games **63**

Game dates **Nov 6, 2026 – Nov 14, 2026**

Counts include every recorded NBA line: graded, void, and ungraded with a reason. Read Nov 16, 00:00 UTC.

## Higher

The final stat beat the closing line.

| Game date | Player | Market | Closing line | Actual | Closed |
| --- | --- | --- | --- | --- | --- |
| 2026-11-14 | Zion Williamson · discounted | points | 20.5 | 24 | 58s before |
| 2026-11-14 | Derik Queen · boosted | rebs_asts | 8.5 | 9 | 58s before |
| 2026-11-14 | Jamal Murray | rebs_asts | 10.5 | 16 | 58s before |
| 2026-11-14 | Karlo Matkovic · discounted | three_points_made | 0.5 | 1 | 58s before |

## Lower

The final stat finished below the closing line.

| Game date | Player | Market | Closing line | Actual | Closed |
| --- | --- | --- | --- | --- | --- |
| 2026-11-14 | Jeremiah Fears | rebounds | 4.5 | 4 | 58s before |
| 2026-11-14 | Saddiq Bey | points | 18.5 | 16 | 58s before |
| 2026-11-14 | Yves Missi | pts_rebs_asts | 12.5 | 12 | 58s before |
| 2026-11-14 | Trevon Brazile · boosted | steals | 0.5 | 0 | 58s before |

## Void

The player did not play, or the line was pulled before the game.

| Game date | Player | Market | Closing line | Actual | Reason |
| --- | --- | --- | --- | --- | --- |
| 2026-11-14 | Jarrett Allen · boosted | three_points_made | 0.5 | — | `dnp` |
| 2026-11-14 | Zach Edey | rebs_asts | 8.5 | — | `dnp` |
| 2026-11-11 | Jamal Cain | steals | 0.5 | — | `dnp` |
| 2026-11-06 | Immanuel Quickley · boosted | steals | 1.5 | — | `dnp` |

## Not graded, with the reason

Rows that cannot be graded say why. None carries a guessed result.

| Game date | Player | Market | Closing line | Actual | Reason |
| --- | --- | --- | --- | --- | --- |
| 2026-11-14 | Nikola Jokic | period_1_2_pts_rebs_asts | 26.5 | — | `unsupported_period` A period other than full game. Not graded yet. |
| 2026-11-14 | Derik Queen | double_doubles | — | — | `no_pre_start_line` No line was recorded before the game started. |
| 2026-11-14 | Jeremiah Fears | double_doubles | — | — | `no_pre_start_line` No line was recorded before the game started. |
| 2026-11-14 | Yves Missi | rebounds | — | 8 | `no_pre_start_line` No line was recorded before the game started. |
| 2026-11-14 | Saddiq Bey · discounted | period_1_points | 3.5 | — | `unsupported_period` A period other than full game. Not graded yet. |
| 2026-11-14 | Zion Williamson · boosted | period_1_points | 5.5 | — | `unsupported_period` A period other than full game. Not graded yet. |
| 2026-11-14 | Christian Braun | points | — | 17 | `no_pre_start_line` No line was recorded before the game started. |
| 2026-11-14 | Jamal Murray · boosted | period_1_2_pts_rebs_asts | 18.5 | — | `unsupported_period` A period other than full game. Not graded yet. |

## How a line is graded

- **Closing line.** The last line recorded at or before the start time. `closing.gap_seconds` says how close to tip-off it was.
- **Final only.** A game is graded only when the scoreboard and the box score are final and the box score reconciles.
- **Void** when the stat equals the line exactly. **Higher** or **Lower** otherwise.
- **Void** for `did_not_play` or `pulled_before_start`. The actual stat stays on the row.
- **Matching** is limited to the player's own team in the matched game, with a 0.9 confidence threshold.
- **Corrections.** Each box score is re-read about 12 hours after it goes final; a corrected stat raises `revision`.

cURL · one night of results

```
curl "https://underdogapi.com/api/v1/results?league=NBA&status=void" \
  -H "Authorization: Bearer $UNDERDOG_API_KEY"
```

## Hit rates in Python

Python · standard library

```
import json, os
from urllib.parse import urlencode
from urllib.request import Request, urlopen

def hit_rates(player, stat=None, last=10):
    params = {"player": player, "last": last, **({"stat": stat} if stat else {})}
    req = Request("https://underdogapi.com/api/v1/hit-rates?" + urlencode(params),
                  headers={"Authorization": "Bearer " + os.environ["UNDERDOG_API_KEY"]})
    with urlopen(req, timeout=20) as r:
        return json.load(r)["data"]

for row in hit_rates("Jayson Tatum"):
    rate = row["higher_hit_rate"]
    print(f'{row["stat"]:<16} {row["higher"]}-{row["lower"]}-{row["void"]}  '
          f'Higher {rate:.0%}' if rate is not None else f'{row["stat"]:<16} no graded games')
```

## Questions

Which line is graded, the opening or the closing line?

The closing line: the last line recorded at or before the game started. Each row reports how many seconds before tip-off that observation was, and marks it confirmed when it was within 15 minutes.

When is an Underdog result void?

A tie to the line is void. Participation and sport-specific void rules also apply; unsupported or unmatched evidence stays ungraded with a reason.

Which leagues and stats are graded?

NBA full-game lines, overtime included, for single-player stats such as points, rebounds, assists, threes, combos like Pts+Rebs+Asts, and fantasy score. Rows that cannot be graded say why and never carry a guessed result.

How do I get hit rates for a player?

GET /api/v1/hit-rates?player=NAME returns Higher, Lower and void counts and the Higher hit rate per stat across graded closing lines, defaulting to one standard line per game. It is on every plan; Free counts the last 10 games.

## Keep going

[Endpoint **GET /api/v1/results** *Every graded row, filterable by date, player, stat and result.*](https://underdogapi.com/docs#results) [Endpoint **GET /api/v1/hit-rates** *Higher hit rate per player and stat.*](https://underdogapi.com/docs#hit-rates) [Guide **Underdog historical data** *Recorded lines and backtests.*](https://underdogapi.com/underdog-historical-data) [Tool **Line and payout explorer** *Current board lines with official multipliers and derived break-evens.*](https://underdogapi.com/tools/line-explorer) [Dataset **Recorded history sample (CSV)** *One completed day of change events, with a coverage calendar.*](https://underdogapi.com/data/history-sample) [Pricing **Plans and request limits** *Free 100 credits a month. Paid plans from $49.*](https://underdogapi.com/pricing)

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

## References

- [API reference: results](https://underdogapi.com/docs#results)
- [API reference: hit rates](https://underdogapi.com/docs#hit-rates)
- [API reference: grading rules](https://underdogapi.com/docs#grading-rules)
- [Keyless JSON of this page](https://underdogapi.com/api/public/graded-examples)

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