{"openapi":"3.1.0","info":{"title":"Sports Jedi API","version":"1.0.0","summary":"Confidence-ranked sports picks, win probabilities and parlay scoring.","description":"Sports Jedi's own analysis for NFL, college football (NCAAF), NBA and MLB: which side the model favors, how confident it is, no-vig win probabilities, and the real combined probability of a parlay.\n\nPlans:\n- **Free** ($0): 100 requests/day, 10/minute\n- **Starter** ($19/mo): 5,000 requests/day, 60/minute\n- **Pro** ($79/mo): 50,000 requests/day, 300/minute\n\nGet a free key at https://sportsjedi.com/developers. Picks are model estimates for information and entertainment, not guarantees or betting advice.","contact":{"name":"Sports Jedi","url":"https://sportsjedi.com/developers"},"termsOfService":"https://sportsjedi.com/terms"},"externalDocs":{"description":"Guides and examples","url":"https://api.sportsjedi.com/v1/docs"},"servers":[{"url":"https://api.sportsjedi.com"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"Picks","description":"Ranked picks and per-game analysis"},{"name":"Games","description":"Games Sports Jedi is tracking"},{"name":"Parlays","description":"Parlay probability"},{"name":"Account","description":"Plan and usage"}],"paths":{"/v1/picks":{"get":{"tags":["Picks"],"operationId":"listPicks","summary":"Ranked picks","description":"Upcoming and live games with Sports Jedi's pick, highest confidence first.","parameters":[{"name":"league","in":"query","schema":{"type":"string","enum":["NFL","NCAAF","NBA","MLB"]}},{"name":"min_confidence","in":"query","schema":{"type":"number","minimum":0,"maximum":100,"default":0}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}}],"responses":{"200":{"description":"Picks","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PickList"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/games":{"get":{"tags":["Games"],"operationId":"listGames","summary":"Games","parameters":[{"name":"league","in":"query","schema":{"type":"string","enum":["NFL","NCAAF","NBA","MLB"]}},{"name":"status","in":"query","schema":{"type":"string","enum":["upcoming","live","final","postponed"]}},{"name":"date","in":"query","description":"UTC date, YYYY-MM-DD","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Games, soonest first","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GameList"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/games/{id}":{"get":{"tags":["Picks"],"operationId":"getGame","summary":"One game with full analysis","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Game and analysis","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GameDetail"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/parlays/analyze":{"post":{"tags":["Parlays"],"operationId":"analyzeParlay","summary":"Score a parlay","description":"Each leg's probability comes from Sports Jedi's model, so the result is the real chance that every leg hits. Up to 12 legs.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParlayRequest"},"example":{"legs":[{"gameId":"4f6688e4d1818bd8bb3e65352c7a0406","pick":"NYK"}]}}}},"responses":{"200":{"description":"Parlay probability","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParlayResult"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/usage":{"get":{"tags":["Account"],"operationId":"getUsage","summary":"Plan and today's usage","responses":{"200":{"description":"Usage","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UsageResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"429":{"$ref":"#/components/responses/RateLimited"}}}},"/v1/leagues":{"get":{"tags":["Games"],"operationId":"listLeagues","summary":"Supported leagues","security":[],"responses":{"200":{"description":"Leagues","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"type":"string","enum":["NFL","NCAAF","NBA","MLB"]}}}}}}}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Keys look like sj_live_… Get one at https://sportsjedi.com/developers"}},"headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Requests allowed per day on your plan"},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Requests left today"},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the daily reset (midnight UTC)"}},"responses":{"BadRequest":{"description":"A parameter is invalid; the message says which","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthorized":{"description":"Missing, invalid or revoked API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Per-minute or daily limit reached; see Retry-After","headers":{"Retry-After":{"schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"string"},"code":{"type":"string","examples":["INVALID_API_KEY"]}}},"Meta":{"type":"object","properties":{"plan":{"type":"string"},"requestsToday":{"type":"integer"},"dailyLimit":{"type":"integer"},"count":{"type":"integer"}}},"Team":{"type":"object","properties":{"name":{"type":"string"},"abbr":{"type":"string"}}},"Game":{"type":"object","required":["id","league","status","away","home"],"properties":{"id":{"type":"string"},"league":{"type":"string","enum":["NFL","NCAAF","NBA","MLB"]},"startTime":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["upcoming","live","final","postponed"]},"away":{"$ref":"#/components/schemas/Team"},"home":{"$ref":"#/components/schemas/Team"}}},"Analysis":{"type":"object","properties":{"pick":{"type":["string","null"],"description":"Abbreviation of the side the model favors"},"confidence":{"type":"number","minimum":0,"maximum":100},"grade":{"type":["string","null"],"examples":["STRONG","PLAY","LEAN","NO PICK"]},"homeWinProbability":{"type":["number","null"]},"awayWinProbability":{"type":["number","null"]},"edge":{"type":["number","null"]},"marketAgreement":{"type":["number","null"]},"summary":{"type":["string","null"]}}},"Pick":{"type":"object","properties":{"game":{"$ref":"#/components/schemas/Game"},"analysis":{"$ref":"#/components/schemas/Analysis"}}},"PickList":{"type":"object","properties":{"success":{"const":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/Pick"}},"meta":{"$ref":"#/components/schemas/Meta"}}},"GameList":{"type":"object","properties":{"success":{"const":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/Game"}},"meta":{"$ref":"#/components/schemas/Meta"}}},"GameDetail":{"type":"object","properties":{"success":{"const":true},"data":{"$ref":"#/components/schemas/Pick"},"meta":{"$ref":"#/components/schemas/Meta"}}},"ParlayRequest":{"type":"object","required":["legs"],"properties":{"legs":{"type":"array","minItems":1,"maxItems":12,"items":{"type":"object","required":["gameId","pick"],"properties":{"gameId":{"type":"string"},"pick":{"type":"string","description":"Team abbreviation"}}}}}},"ParlayResult":{"type":"object","properties":{"success":{"const":true},"data":{"type":"object","properties":{"combinedConfidence":{"type":"number"},"risk":{"type":"string","examples":["Lower","Medium","High"]},"message":{"type":"string"},"legs":{"type":"array","items":{"type":"object","properties":{"gameId":{"type":"string"},"pick":{"type":"string"},"confidence":{"type":"number"},"game":{"$ref":"#/components/schemas/Game"}}}}}},"meta":{"$ref":"#/components/schemas/Meta"}}},"UsageResponse":{"type":"object","properties":{"success":{"const":true},"data":{"type":"object","properties":{"plan":{"type":"string"},"requestsToday":{"type":"integer"},"dailyLimit":{"type":"integer"},"remainingToday":{"type":"integer"},"perMinuteLimit":{"type":"integer"}}}}}}}}