# Measured reliability

> Inspect recorded Underdog board freshness, stream gaps, ingest latency and uptime. Unknown measurements stay unavailable until evidence exists. 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/reliability

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

Reliability



How fresh each league’s complete board is, how many line changes the stream missed, how fast gaps were repaired, and uptime over real windows. Every figure names its window. “No data yet” means the records do not span it.

[Live status](https://underdogapi.com/status) [Incidents](https://underdogapi.com/incidents) [History coverage](https://underdogapi.com/history-coverage) [JSON](https://underdogapi.com/reliability.json)

Line moves only a full board found, 7 days

No data yet

0 whole hours counted

Stream gaps counted

No data yet

Sampling not started

Board collection uptime, 7 days

85.71%

Five-minute intervals with a board

League board commit p95, 24 hours

No data yet

Fetch to database

## Complete-board freshness

A full league board compares every line we hold for that league against the source. Age is the time since the last one. Interval is the time between consecutive boards for a league. A complete board is one the source handed over whole.

Measured 2026-11-15 19:41 UTC

| League | Lines listed | Age of last board | Age of last complete board | Complete boards, 24h | Interval p50, 24h | Interval p95, 24h | Longest, 24h | Interval p95, 7d | Complete / partial / failed, 24h |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| BKFC | 0 | 6 min | 6 min | 803 of 803 | 2 min | 3 min | 5 min | 3 min | 803 / 0 / 0 |
| CBB | 6 | 6 min | 6 min | 803 of 803 | 2 min | 3 min | 5 min | 3 min | 803 / 0 / 0 |
| CFB | 0 | 6 min | 6 min | 803 of 803 | 2 min | 3 min | 5 min | 3 min | 803 / 0 / 0 |
| CFL | 0 | 6 min | 6 min | 803 of 803 | 2 min | 3 min | 5 min | 3 min | 803 / 0 / 0 |
| CS | 18 | 6 min | 6 min | 803 of 803 | 2 min | 3 min | 5 min | 3 min | 803 / 0 / 0 |
| DOTA | 0 | 6 min | 6 min | 803 of 803 | 2 min | 3 min | 5 min | 3 min | 803 / 0 / 0 |
| FIFA | 0 | 6 min | 6 min | 803 of 803 | 2 min | 3 min | 5 min | 3 min | 803 / 0 / 0 |
| INTLBASKETBALL | 0 | 6 min | 6 min | 803 of 803 | 2 min | 3 min | 5 min | 3 min | 803 / 0 / 0 |
| KBO | 0 | 6 min | 6 min | 803 of 803 | 2 min | 3 min | 5 min | 3 min | 803 / 0 / 0 |
| LOL | 0 | 6 min | 6 min | 803 of 803 | 2 min | 3 min | 5 min | 3 min | 803 / 0 / 0 |
| MMA | 0 | 6 min | 6 min | 803 of 803 | 2 min | 3 min | 5 min | 3 min | 803 / 0 / 0 |
| MOTORSPORTS | 0 | 6 min | 6 min | 803 of 803 | 2 min | 3 min | 5 min | 3 min | 803 / 0 / 0 |
| NBA | 128 | 6 min | 6 min | 803 of 803 | 2 min | 3 min | 5 min | 3 min | 803 / 0 / 0 |
| NFL | 305 | 6 min | 6 min | 803 of 803 | 2 min | 3 min | 5 min | 3 min | 803 / 0 / 0 |
| NHL | 40 | 6 min | 6 min | 803 of 803 | 2 min | 3 min | 5 min | 3 min | 803 / 0 / 0 |
| OUTLAWS | 0 | 6 min | 6 min | 803 of 803 | 2 min | 3 min | 5 min | 3 min | 803 / 0 / 0 |
| PGA | 0 | 6 min | 6 min | 803 of 803 | 2 min | 3 min | 5 min | 3 min | 803 / 0 / 0 |
| TENNIS | 362 | 6 min | 6 min | 803 of 803 | 2 min | 3 min | 5 min | 3 min | 803 / 0 / 0 |

A byte-identical board and an ingested board both count as a comparison. The run counts cover ingested boards only.

## Stream against the full board

Of the line moves or removals recorded for a league, the share the WebSocket did not deliver and a REST board found. Counted from the first whole hour after the stream started. An upper bound on what the stream lost, because a poll can land first. Replayed events and first-seen lines are left out: the stream cannot announce a line it has never seen.

No measurement stored yet. No data yet.

| Window | Moves from stream | Moves only a board found | Missing rate, moves | Removals from stream | Removals only a board found | Missing rate, removals |
| --- | --- | --- | --- | --- | --- | --- |
| No data yet |  |  |  |  |  |  |

## WebSocket health

Connection health only. A connected stream says nothing about whether a league’s complete board is fresh. Those are the tables above.

No measurement stored yet. No data yet.

At last measurement

No data yet

Both channels and healthy imports

Gaps, current process

No data yet

Since the worker started

Reconnects, current process

No data yet

Since the worker started

Process restarts seen

No data yet

Sampling not started

## Stream gaps and repair

On reconnect the client asks the source to resume from its last position and records any discontinuity. The next complete league board then reconciles current lines: a REST row with a newer source revision corrects the stored line. Recovery time runs from a gap until every league on the board has had a complete board after it.

Gaps counted since sampling began

No data yet

Sampling not started

Gap duration p50

No data yet

From the durable gap log

Reconnect time p50

No data yet

Disconnect to resume

Recovery time p50

No data yet

Gap to every league reconciled

A gap is a discontinuous stream position, or a recovery the source could not complete. Every gap is logged with its last publication, disconnect and resume times. Duration runs from the disconnect to the resume, or between the two receipts when the connection stayed up. Publications skipped is the offset jump within one stream epoch.

## Ingest lag

Each row names its two clocks below.

Measured 2026-11-15 19:41 UTC

| Measure | Window | Samples | p50 | p95 | p99 |
| --- | --- | --- | --- | --- | --- |
| League board, fetch to commit | 24 hours | No data yet | No data yet | No data yet | No data yet |
| All-leagues board, fetch to commit | 24 hours | 803 | 2.7 s | 3.6 s | 4.0 s |
| Source update to fetch | 24 hours | No data yet | No data yet | No data yet | No data yet |
| League board, fetch to commit | 7 days | No data yet | No data yet | No data yet | No data yet |
| All-leagues board, fetch to commit | 7 days | 4,892 | 2.8 s | 3.8 s | 4.2 s |
| Source update to fetch | 7 days | No data yet | No data yet | No data yet | No data yet |
| Stream offer, source to receipt | 24 hours | No data yet | No data yet | No data yet | No data yet |
| Stream score, source to receipt | 24 hours | No data yet | No data yet | No data yet | No data yet |
| Stream receipt to commit | 24 hours | No data yet | No data yet | No data yet | No data yet |
| Stream receipt to commit | 7 days | No data yet | No data yet | No data yet | No data yet |

Board fetch to commit

From fetching a board to committing it in the database. Exact percentiles over full ingests.

Source update to fetch

From the source update time on a changed line to the fetch that saw it. p50 and p95 are stored per ingest and weighted by updates. p99 comes from bucket counts over every update in the window and reads as the upper edge of its bucket.

Stream source to receipt

From the source timestamp on a stream publication to our receipt. Offers use the newest revision of each line; scores use stored score changes. Negative samples are clock skew and are excluded and counted. Between two different clocks, so read it as an estimate.

Stream receipt to commit

From receipt to the commit of its batch, for every publication. Counted into fixed buckets each minute, so each percentile reads as the upper edge of its bucket.

## Uptime over real windows

A window appears once the records span all of it. Until then it says how many days exist.

Measured 2026-11-15 19:31 UTC

| Measure | 24 hours | 7 days | 30 days | 90 days |
| --- | --- | --- | --- | --- |
| Board collection | 100.00% | 85.71% | No data yet: 8.8 d recorded | No data yet: 8.8 d recorded |
| API requests without a 5xx | 100.00% 0 of 1,290 | 99.93% 1 of 1,386 | No data yet: 8.8 d recorded | — |
| REST requests to the source | 1,817 34 failed, 0 limited, 0 blocked | 9,291 61 failed, 0 limited, 0 blocked | No data yet: 8.8 d recorded | No data yet: 8.8 d recorded |
| WebSocket connected, sampled | No data yet | No data yet | No data yet | No data yet |

External probes, dated evidence through  UTC

| Endpoint | First probe | Last probe | Checks | Failed | Passed |
| --- | --- | --- | --- | --- | --- |

Board collection

Share of five-minute intervals containing at least one successfully ingested board. Time-weighted over the window. Windows past 30 days read a daily rollup of whole UTC days.

API requests

Share of recorded non-demo API requests that did not return a 5xx. Weighted by requests, so a quiet period counts for little. Probes and customers are both included.

REST requests

Every REST request to the source and its outcome.

External probes

Pass rate of recorded synthetic probes only. No measurements or regional coverage are inferred. Download the evidence.

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