API — Feeling Clutch

Authentication

Send your API key on every request using either header:

Authorization: Bearer fc_…
X-API-Key: fc_…

Keys are tied to your portal account and subscription. Revoked or invalid keys return 401.

API keys

Create keys from the API keys page after signing in. Each key is shown once at creation — copy and store it securely.

Action	Method	Path	Auth
List keys	`GET`	`/api/user/api-keys`	Session cookie
Create key	`POST`	`/api/user/api-keys`	Session cookie
Revoke key	`DELETE`	`/api/user/api-keys/{id}`	Session cookie

Create request body: {"name": "My integration"}

Pregame predictions

Returns pregame model scores for each game on a slate.

GET /api/v1/predictions/pregame

Query parameters

Parameter	Required	Description
`league`	Yes	`nba`, `wnba`, `nfl`, or `mlb` (WNBA omitted when disabled on the server)
`date`	No	Slate date `YYYY-MM-DD` (Eastern). Defaults to today. Cannot be in the future.

Access by date

Today — requires paid live access for that league
Past dates — requires historical access (included on the free plan)

Example request

curl -s "/api/v1/predictions/pregame?league=nba&date=2026-06-07" \
  -H "Authorization: Bearer fc_YOUR_KEY_HERE"

Example response

{
  "league": "nba",
  "date": "2026-06-07",
  "games": [
    {
      "gameId": "0022500001",
      "homeTeam": { "abbreviation": "BOS", "name": "Boston Celtics" },
      "awayTeam": { "abbreviation": "NYK", "name": "New York Knicks" },
      "predictedHomeScore": 112.5,
      "predictedAwayScore": 108.0,
      "predictedTotal": 220.5,
      "predictedSpread": "BOS -4.5"
    }
  ]
}

Response fields

Field	Description
`league`	League requested
`date`	Slate date (`YYYY-MM-DD`)
`games[].gameId`	League-specific game identifier
`games[].homeTeam` / `awayTeam`	`abbreviation` and optional `name`
`predictedHomeScore` / `predictedAwayScore`	Model pregame projected scores
`predictedTotal`	Sum of home and away predicted scores
`predictedSpread`	Favored team and line (e.g. `BOS -4.5`). Spread is `away − home`; negative means home is favored.

Games without a stored pregame prediction are omitted from the list.

Errors

Status	Meaning
`400`	Invalid `league` or `date`
`401`	Missing, invalid, or revoked API key
`403`	Your plan does not include access for that league/date
`502`	Upstream sport app unavailable

Error bodies are JSON: {"detail": "…"}

Coming soon

Live in-game predictions (NBA) will be added as a separate endpoint.

Predictions API