# Know what each call costs.

> Predictable weighted credits for Underdog API endpoints, with a usage calculator. 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/credits

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

Credits a month: Free 100 for $0, Developer 10,000 for $49, Production 50,000 for $149, Scale 250,000 for $499. Existing paid request-based subscriptions keep their current allowance; a new subscription uses the terms shown at checkout.

| Endpoint | Credits per started 100 rows | With view=compact | Default page | Largest page |
| --- | --- | --- | --- | --- |
| `/changes` Every line change after your cursor. The cheap way to stay current. | 1 | 1 | 50 rows, 1 credits | 200 rows, 2 credits |
| `/projections` The current board with per-side payout multipliers and line context. | 3 | 1 | 50 rows, 3 credits | 200 rows, 6 credits |
| `/board` The board at one moment. | 3 | 1 | 50 rows, 3 credits | 200 rows, 6 credits |
| `/odds` Per-side prices across lines, with implied probabilities. | 3 | 1 | 50 rows, 3 credits | 200 rows, 6 credits |
| `/hit-rates` How often a player went Higher or Lower against past lines. | 5 | 2 | 50 rows, 5 credits | 200 rows, 10 credits |
| `/projections/{id}/history` Every recorded move of one line. | 10 | 4 | 50 rows, 10 credits | 200 rows, 20 credits |
| `/training-set` Labelled rows for model training: opening line, close, result. | 10 | 4 | 100 rows, 10 credits | 1000 rows, 100 credits |
| `/export` CSV export of lines. | 3 | 1 | 50 rows, 3 credits | 1000 rows, 30 credits |
| `/projections/{id}/alternates` Alternate rungs of one line. | 1 | 1 | 50 rows, 1 credits | 200 rows, 2 credits |
| `/results` Graded lines: Higher, Lower or void. | 1 | 1 | 50 rows, 1 credits | 200 rows, 2 credits |
| `/game-logs` Box-score lines per player and game. | 1 | 1 | 50 rows, 1 credits | 200 rows, 2 credits |
| `/team-stats` Team box scores. | 1 | 1 | 50 rows, 1 credits | 200 rows, 2 credits |
| `/opponent-stats` What opponents allowed. | 1 | 1 | 50 rows, 1 credits | 200 rows, 2 credits |
| `/players` Player directory. | 1 | 1 | 50 rows, 1 credits | 200 rows, 2 credits |
| `/fixtures` Games and start times. | 1 | 1 | 50 rows, 1 credits | 200 rows, 2 credits |
| `/fixtures/{id}` One game. | 1 | 1 | 50 rows, 1 credits | 200 rows, 2 credits |
| `/injuries` Injury reports. | 1 | 1 | 500 rows, 5 credits | 2000 rows, 20 credits |
| `/multipliers` Payout multipliers by line. | 1 | 1 | 50 rows, 1 credits | 200 rows, 2 credits |
| `/payouts` Standard, Flex and Streaks payout tables. | 1 | 1 | 50 rows, 1 credits | 200 rows, 2 credits |
| `/live-stats` Running player totals during games. | 1 | 1 | 50 rows, 1 credits | 200 rows, 2 credits |
| `/events` Historical play-by-play events. | 1 | 1 | 50 rows, 1 credits | 200 rows, 2 credits |
| `/events/catalog` Which games have play events. | 1 | 1 | 50 rows, 1 credits | 100 rows, 1 credits |
| Any read with `as_of` | 10 | 4 | Priced like history |  |
| `/stream` One live-feed connection, at most 285 seconds. | 2 per call |  |  |  |
| `/coverage` What is tracked right now. | 0 per call |  |  |  |
| `/credit-costs` This table, and a quote for any path. | 0 per call |  |  |  |
| Errors, refused calls (402, 429) and unchanged 304 responses | 0 |  |  |  |

A full board page of 200 rows costs 6 credits; the same page with view=compact costs 2. A change-feed poll of up to 100 rows costs 1. A call is admitted at the page it asked for and charged for the rows it served, every started 100, at least one page: an empty page costs one page. It does not fluctuate with server speed.

Every response carries X-Credits-Charged, X-Credits-Remaining and X-Credits-Limit-Month, and JSON bodies meta.credits_charged and meta.remaining. From 80% of the month, meta.usage_notice says how many are left. A refused call (402, 429), an error or an unchanged 304 costs nothing; protective per-minute limits still apply. No automatic overage charges.

## Estimate your usage

Estimate for 30 days. Credits reset each UTC calendar month; unused credits do not roll over.

Endpoint Requested rows Calls per day

**1 credits per call · 300 credits per 30 days**

Developer: 10,000 credits/month. Production: 50,000. Scale: 250,000. Endpoint row limits still apply; smaller pages may be required. Live-feed connections last up to 285 seconds and reconnects consume credits.

[Compare plans](https://underdogapi.com/pricing) · [Run a scheduled job](https://underdogapi.com/docs/scheduled-jobs) · [First call, request counting and streaming costs](https://underdogapi.com/docs/first-call)

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