Sports Jedi API · v1

Sports picks your app can use.

Confidence-ranked picks, win probabilities and parlay scoring for NFL, college football, NBA and MLB, as clean JSON. The same model behind sportsjedi.com.

Get a free API key Quick start OpenAPI spec
Ranked picksEvery game's side, confidence score and grade, best first.
Win probabilitiesNo-vig home and away probabilities plus edge.
Parlay scoringReal combined probability for any set of legs.
Four leaguesNFL, NCAAF, NBA and MLB, updated all day.

Quick start

1. Sign in at sportsjedi.com/developers and create a key. 2. Call the API:

curl https://api.sportsjedi.com/v1/picks?league=NFL \
  -H "X-API-Key: sj_live_your_key_here"

JavaScript

const res = await fetch("https://api.sportsjedi.com/v1/picks?league=NBA&min_confidence=70", {
  headers: { "X-API-Key": process.env.SPORTS_JEDI_API_KEY },
});
const { data } = await res.json();

Python

import os, requests
r = requests.get("https://api.sportsjedi.com/v1/picks", params={"league": "NCAAF"},
                 headers={"X-API-Key": os.environ["SPORTS_JEDI_API_KEY"]})
picks = r.json()["data"]

Authentication

Send your key in the X-API-Key header on every request. Keys start with sj_live_. Keep them on your server; browsers are blocked from calling the API directly so keys can't leak from web pages. You can revoke and create keys anytime at sportsjedi.com/developers.

Plans

PlanPriceRequests / dayRequests / minKeys
Free$0100102
Starter$19/mo5,000605
Pro$79/mo50,00030010

Limits are per account and reset at midnight UTC. Upgrade or cancel anytime from your developer page.

Endpoints

Base URL: https://api.sportsjedi.com. All responses are JSON: {"success": true, "data": ..., "meta": {...}}.

GET /v1/picks

Today's Sports Jedi picks, highest confidence first. Games that are final are left out.

ParameterMeaning
leagueNFL, NCAAF, NBA or MLB (optional)
min_confidence0-100, default 0
limit1-200, default 50

Response

{
  "success": true,
  "data": [{
    "game": { "id": "4f6688e4d1818bd8...", "league": "NBA", "startTime": "2026-11-05T00:30:00Z",
              "status": "upcoming", "away": { "name": "Chicago Bulls", "abbr": "CB" },
              "home": { "name": "New York Knicks", "abbr": "NYK" } },
    "analysis": { "pick": "NYK", "confidence": 78, "grade": "PLAY",
                  "homeWinProbability": 71.4, "awayWinProbability": 28.6, "edge": 21.4,
                  "marketAgreement": 100, "summary": "NYK is the market-consensus side..." }
  }],
  "meta": { "plan": "starter", "requestsToday": 41, "dailyLimit": 5000, "count": 1 }
}

GET /v1/games

Games Sports Jedi is tracking, soonest first.

ParameterMeaning
leagueNFL, NCAAF, NBA or MLB (optional)
statusupcoming, live, final or postponed
dateYYYY-MM-DD (UTC)

GET /v1/games/{id}

One game with its full Sports Jedi analysis.

ParameterMeaning
ida game id from /v1/games or /v1/picks

POST /v1/parlays/analyze

Score a parlay. Each leg's probability comes from Sports Jedi's model, so the result reflects the real chance every leg hits. Up to 12 legs.

Request body

{ "legs": [ { "gameId": "4f6688e4d1818bd8...", "pick": "NYK" },
             { "gameId": "a91c02b7e4f3...",     "pick": "KC"  } ] }

Response

{
  "success": true,
  "data": { "legs": 2, "combinedConfidence": 52.1, "risk": "Medium",
            "message": "2-leg card has approximately 52.1% combined model probability..." }
}

GET /v1/usage

Your plan, requests used today and what's left.

GET /v1/leagues

Supported leagues. No key needed.

Errors & rate limits

Errors look like {"success": false, "error": "message", "code": "CODE"}.

StatusCodeMeaning
400INVALID_LEAGUE, INVALID_LEGS, …A parameter is wrong; the message says which.
401API_KEY_REQUIRED, INVALID_API_KEYMissing, wrong or revoked key.
403PLAN_REQUIREDYour plan doesn't include this endpoint.
404NOT_FOUNDNo game with that id.
429RATE_LIMITED, DAILY_QUOTA_EXCEEDEDSlow down; see Retry-After.

Every keyed response includes X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset (seconds until the daily reset).

Terms

Sports Jedi provides sports analysis for information and entertainment. Picks and probabilities are model estimates, not guarantees and not betting advice. If you show them to people, say so, follow the gambling laws where your users are, and point anyone who needs it to help such as 1-800-GAMBLER.

Questions: sportsjedi.com