{"openapi":"3.1.0","info":{"title":"GetOdds data gateway","version":"0.8.0","description":"The Odds API v4-compatible routes at every GetOdds book (DraftKings, FanDuel, BetRivers, Pinnacle, Novig) with per-event player props and scores; DraftKings and FanDuel DFS slates and salaries; Player props at every book (FanDuel, DraftKings, BetRivers, Pinnacle, Novig, PrizePicks, Underdog, DK Pick6) with line history, Novig exchange prices, scoped player thresholds from four sources, DraftKings-via-ESPN prices, native FanDuel and BetRivers US-PA prices, and explicitly bounded analysis and evidence APIs. Price analysis is conditional; computed assessments are not official sportsbook settlements."},"servers":[{"url":"https://getoddsapi.com"}],"paths":{"/api/v1/props":{"get":{"operationId":"listPlayerProps","summary":"Player props at every book, merged per player, stat and game day","description":"Open to every valid key; one credit per page. Pregame lines for games in the next 48 hours from FanDuel, DraftKings, BetRivers, Pinnacle and Novig (two-sided prices) and PrizePicks, Underdog and DK Pick6 (pick’em lines). Each row carries every book’s quote, the median line, the best over and under, a no-vig fair price and the largest pick’em gap. Sources are read at most every 2 minutes.","security":[{"bearerKey":[]}],"parameters":[{"name":"sport","in":"query","required":true,"schema":{"type":"string","enum":["nba","nfl","nhl","ncaaf","ncaab"]}},{"name":"books","in":"query","description":"Comma list; summary fields are computed over these books only.","schema":{"type":"string","example":"fanduel,draftkings,novig"}},{"name":"player","in":"query","description":"Player name or part of it (accents and suffixes ignored).","schema":{"type":"string","minLength":2,"maxLength":80}},{"name":"stat","in":"query","description":"Canonical stat key, e.g. points, rebounds, threes, pra, passing_yards, rushing_yards, receiving_yards, receptions, shots_on_goal.","schema":{"type":"string","pattern":"^[a-z_]{2,40}$"}},{"name":"date","in":"query","description":"Game day, US Eastern.","schema":{"type":"string","format":"date"}},{"name":"min_books","in":"query","schema":{"type":"integer","minimum":1,"maximum":8,"default":1}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}}],"responses":{"200":{"description":"Merged prop rows, soonest game first.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","maxItems":200,"items":{"type":"object","properties":{"id":{"type":"string"},"player":{"type":"string"},"team":{"type":["string","null"]},"stat":{"type":"string"},"stat_label":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"game_date":{"type":"string","format":"date"},"event":{"type":["string","null"]},"books":{"type":"integer"},"quotes":{"type":"object","propertyNames":{"enum":["fanduel","draftkings","betrivers","pinnacle","novig","prizepicks","underdog","pick6"]},"additionalProperties":{"type":"object","properties":{"id":{"type":["string","null"]},"line":{"type":"number"},"over":{"type":["integer","null"]},"under":{"type":["integer","null"]},"priced":{"type":"boolean"},"raw_stat":{"type":"string"},"event":{"type":["string","null"]},"observed_at":{"type":"string","format":"date-time"},"history":{"type":"boolean","description":"true: pass id to /api/v1/props/history."}}}},"consensus_line":{"type":["number","null"]},"best_over":{"type":["object","null"],"properties":{"book":{"enum":["fanduel","draftkings","betrivers","pinnacle","novig","prizepicks","underdog","pick6"]},"line":{"type":"number"},"price":{"type":"integer"}}},"best_under":{"type":["object","null"],"properties":{"book":{"enum":["fanduel","draftkings","betrivers","pinnacle","novig","prizepicks","underdog","pick6"]},"line":{"type":"number"},"price":{"type":"integer"}}},"no_vig":{"type":["object","null"],"properties":{"book":{"enum":["pinnacle","novig"]},"line":{"type":"number"},"over_prob":{"type":"number"},"over":{"type":"integer"},"under":{"type":"integer"}}},"pickem_gap":{"type":["object","null"],"properties":{"book":{"enum":["prizepicks","underdog","pick6"]},"line":{"type":"number"},"consensus":{"type":"number"},"diff":{"type":"number"},"side":{"enum":["over","under"]}}}}}},"pagination":{"type":"object","properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}},"meta":{"type":"object","properties":{"sport":{"enum":["nba","nfl","nhl","ncaaf","ncaab"]},"checked_at":{"type":"string","format":"date-time"},"sources":{"type":"object","additionalProperties":{"enum":["available","empty","unavailable","not_carried"]}},"books":{"type":"array"},"semantics":{"type":"object"}}},"request_id":{"type":"string"}}}}}},"400":{"description":"Invalid query, invalid key, unknown id, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid query, invalid key, unknown id, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid query, invalid key, unknown id, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid query, invalid key, unknown id, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Invalid query, invalid key, unknown id, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid query, invalid key, unknown id, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Invalid query, invalid key, unknown id, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/props/history":{"get":{"operationId":"getPlayerPropHistory","summary":"Line and price history of one prop quote, with its open and close","description":"Open to every valid key; one credit. Pass the book and a quote id from /api/v1/props (quotes with history=true). Points are oldest first. close is the last quote at or before the start (closed=true once the game has started). FanDuel: every new line, line move, price move and removal. PrizePicks: every new, changed, pulled and restored line. Novig: best-bid changes (about 30 days kept) with the no-vig fair open and close. Underdog: change-only main-line history. DraftKings: every change of the market’s main line and both prices (New Jersey, else New York). Pick6 (book=pick6 or dk_pick6): the first stored sighting of the main line, then every main-line move, pause and restore.","security":[{"bearerKey":[]}],"parameters":[{"name":"book","in":"query","required":true,"schema":{"type":"string","enum":["fanduel","prizepicks","novig","underdog"]}},{"name":"id","in":"query","required":true,"schema":{"type":"string","maxLength":80}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":200}}],"responses":{"200":{"description":"History for one line.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"book":{"enum":["fanduel","prizepicks","novig","underdog"]},"id":{"type":"string"},"line":{"type":["object","null"],"properties":{"player":{"type":["string","null"]},"stat":{"type":["string","null"]},"starts_at":{"type":["string","null"],"format":"date-time"},"event":{"type":["string","null"]}}},"open":{"type":["object","null"],"properties":{"observed_at":{"type":"string","format":"date-time"},"line":{"type":["number","null"]},"over":{"type":["integer","null"]},"under":{"type":["integer","null"]}}},"close":{"type":["object","null"],"properties":{"observed_at":{"type":"string","format":"date-time"},"line":{"type":["number","null"]},"over":{"type":["integer","null"]},"under":{"type":["integer","null"]},"closed":{"type":"boolean"}}},"points":{"type":"array","items":{"type":"object","properties":{"observed_at":{"type":"string","format":"date-time"},"kind":{"type":"string"},"line":{"type":["number","null"]},"over":{"type":["integer","null"]},"under":{"type":["integer","null"]},"status":{"type":["string","null"]}}}},"truncated":{"type":"boolean"},"notes":{"type":"array","items":{"type":"string"}}}},"request_id":{"type":"string"}}}}}},"400":{"description":"Invalid query, invalid key, unknown id, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid query, invalid key, unknown id, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid query, invalid key, unknown id, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid query, invalid key, unknown id, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Invalid query, invalid key, unknown id, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid query, invalid key, unknown id, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Invalid query, invalid key, unknown id, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/novig/markets":{"get":{"operationId":"listNovigMarkets","summary":"Novig exchange pregame prices: game lines and player props","description":"Open to every valid key; one credit per page. Novig is a no-vig exchange: price_american and price_decimal convert the ask (the price a taker gets, 1 minus the best bid on the other side), fair is the no-vig mid. Pregame markets carry no taker fee. Open markets seen in the last 20 minutes, starting in the next 7 days. is_main marks the most balanced strike per event and market (per player for props).","security":[{"bearerKey":[]}],"parameters":[{"name":"league","in":"query","schema":{"type":"string","enum":["NFL","NBA","NHL","NCAAF","NCAAB","MLB","EPL","MLS","LA_LIGA","BUNDESLIGA","SERIE_A","LIGUE_1","ATP","WTA"],"default":"NFL"}},{"name":"market","in":"query","schema":{"type":"string","enum":["moneyline","spread","total","team_total","player_prop"]}},{"name":"event_id","in":"query","schema":{"type":"string"}},{"name":"player","in":"query","description":"Player name or slug (player props).","schema":{"type":"string","maxLength":80}},{"name":"alternates","in":"query","description":"Every strike, not only the main line.","schema":{"type":"boolean","default":false}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":5000,"default":0}}],"responses":{"200":{"description":"Priced markets.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","maxItems":200,"items":{"type":"object","properties":{"id":{"type":"string"},"source":{"const":"novig"},"bookmaker":{"const":"novig"},"league":{"enum":["NFL","NBA","NHL","NCAAF","NCAAB","MLB","EPL","MLS","LA_LIGA","BUNDESLIGA","SERIE_A","LIGUE_1","ATP","WTA"]},"event":{"type":"object","properties":{"id":{"type":["string","null"]},"name":{"type":["string","null"]},"home":{"type":["string","null"]},"away":{"type":["string","null"]},"starts_at":{"type":"string","format":"date-time"}}},"market":{"enum":["moneyline","spread","total","team_total","player_prop"]},"native_market_type":{"type":"string"},"description":{"type":["string","null"]},"line":{"type":["number","null"]},"player":{"type":["string","null"]},"player_slug":{"type":["string","null"]},"team_slug":{"type":["string","null"]},"stat":{"type":["string","null"]},"is_main":{"type":"boolean"},"outcomes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"side":{"type":["string","null"]},"bid":{"type":["number","null"]},"ask":{"type":["number","null"]},"fair":{"type":["number","null"]},"price_american":{"type":["integer","null"]},"price_decimal":{"type":["number","null"]},"fair_american":{"type":["integer","null"]},"bid_qty":{"type":["number","null"]}}}},"volume":{"type":["number","null"]},"open_interest":{"type":["number","null"]},"observed_at":{"type":"string","format":"date-time"}}}},"coverage":{"type":"object"},"meta":{"type":"object","properties":{"source":{"const":"novig"},"observed_at":{"type":["string","null"]},"history":{"const":true}}},"pagination":{"type":"object","properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}},"request_id":{"type":"string"}}}}}},"400":{"description":"Invalid query, invalid key, unknown id, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid query, invalid key, unknown id, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid query, invalid key, unknown id, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid query, invalid key, unknown id, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Invalid query, invalid key, unknown id, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid query, invalid key, unknown id, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Invalid query, invalid key, unknown id, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/dfs/slates":{"get":{"operationId":"listDfsSlates","summary":"DraftKings and FanDuel DFS slates with salaries","description":"Open to every valid key; one credit per call. Upcoming DraftKings draft groups and FanDuel slates (next 60 days) from GetOdds’ stored collectors. Only slates with salaries by default (classic and showdown); FanDuel test slates are excluded.","security":[{"bearerKey":[]}],"parameters":[{"name":"site","in":"query","schema":{"type":"string","enum":["draftkings","fanduel"]},"description":"Default: both."},{"name":"sport","in":"query","schema":{"type":"string","enum":["NFL","NBA","NHL","MLB","NCAAF","NCAAB","SOCCER","MMA","GOLF","NASCAR","TENNIS","WNBA","LOL","CS2"]}},{"name":"include_started","in":"query","schema":{"type":"string","enum":["true","false"]},"description":"Also list slates that locked in the last 12 hours."},{"name":"include_unsalaried","in":"query","schema":{"type":"string","enum":["true","false"]},"description":"Also list snake, tiers and pick-style groups (no salaries)."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":5000,"default":0}}],"responses":{"200":{"description":"Slates, earliest first.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","pagination","request_id"],"properties":{"request_id":{"type":"string"},"data":{"type":"array","items":{"type":"object","required":["id","site","sport","starts_at","players","players_with_salary","salaries_url"],"properties":{"id":{"type":"string","description":"DraftKings draft group id or FanDuel slate id."},"site":{"type":"string","enum":["draftkings","fanduel"]},"sport":{"type":"string"},"site_sport":{"type":"string","description":"The site’s own sport code (CFB, CBB, SOC)."},"label":{"type":["string","null"]},"featured":{"type":["boolean","null"]},"starts_at":{"type":"string","format":"date-time"},"game_count":{"type":["integer","null"]},"game_type_id":{"type":["integer","null"],"description":"DraftKings game type id (classic, showdown, tiers differ)."},"salary_cap":{"type":["integer","null"],"description":"FanDuel salary cap; DraftKings does not publish it here."},"players":{"type":"integer"},"players_with_salary":{"type":"integer"},"observed_at":{"type":["string","null"],"format":"date-time"},"salaries_url":{"type":"string"}}}},"meta":{"type":"object"},"pagination":{"type":"object","properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}}}}}}},"400":{"description":"Invalid query (INVALID_QUERY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid or revoked key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No stored players for this slate (SLATE_NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Allowance reached; see Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stored DFS data unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/dfs/salaries":{"get":{"operationId":"listDfsSalaries","summary":"Player salaries for one DraftKings or FanDuel DFS slate","description":"Open to every valid key; one credit per page. Every player in the slate with the site’s posted salary, position, team, game and status; FanDuel adds its FPPG. Highest salary first. A DraftKings classic player appears once with every roster slot he can fill.","security":[{"bearerKey":[]}],"parameters":[{"name":"site","in":"query","required":true,"schema":{"type":"string","enum":["draftkings","fanduel"]}},{"name":"slate_id","in":"query","required":true,"schema":{"type":"string","pattern":"^\\d{1,12}$"},"description":"id from /api/v1/dfs/slates."},{"name":"position","in":"query","schema":{"type":"string"},"description":"e.g. PG, QB, C."},{"name":"team","in":"query","schema":{"type":"string"},"description":"Team abbreviation, e.g. BOS."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000,"default":500}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}}],"responses":{"200":{"description":"Salaries.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","pagination","request_id"],"properties":{"request_id":{"type":"string"},"data":{"type":"array","items":{"type":"object","required":["site","slate_id","id","name","salary"],"properties":{"site":{"type":"string","enum":["draftkings","fanduel"]},"slate_id":{"type":"string"},"id":{"type":"string"},"player_id":{"type":["string","null"]},"name":{"type":"string"},"position":{"type":["string","null"]},"positions":{"type":"array","items":{"type":"string"}},"roster_slot_ids":{"type":"array","items":{"type":"integer"},"description":"DraftKings roster slots this row can fill; one row per player and salary."},"draftable_ids":{"type":"array","items":{"type":"string"},"description":"DraftKings draftable ids merged into this row."},"team":{"type":["string","null"]},"salary":{"type":["integer","null"],"description":"The site’s posted salary; null when the group has none."},"game":{"type":["string","null"]},"game_starts_at":{"type":["string","null"],"format":"date-time"},"fppg":{"type":["number","null"],"description":"FanDuel’s own fantasy points per game."},"status":{"type":["string","null"],"description":"Injury or availability tag (GTD, O, Q...)."},"injury_details":{"type":["string","null"]},"observed_at":{"type":["string","null"],"format":"date-time"}}}},"meta":{"type":"object"},"pagination":{"type":"object","properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}}}}}}},"400":{"description":"Invalid query (INVALID_QUERY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid or revoked key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No stored players for this slate (SLATE_NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Allowance reached; see Retry-After","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Stored DFS data unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/betrivers/markets":{"get":{"operationId":"listBetRiversNativeMarkets","summary":"Read BetRivers US-PA native pregame priced markets","description":"Requires an explicit betrivers source grant AND selected bookmaker before upstream I/O. Existing keys gain no automatic grant. One shared credit per successful page. One bounded fixed-host native request, no credentials or redirects. Only future NOT_STARTED events and native OPEN priced outcomes. Preserves native criterion lifetime/occurrence, IDs, independent American/decimal display values, and per-outcome changedDate. No fabricated odds, historical retention, canonical mapping or settlement equivalence. League lists are partial; use event_id for event detail. Unknown/repeated queries fail. See /docs/betrivers.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"type":"string","const":"betrivers","default":"betrivers"}},{"name":"league","in":"query","description":"NBA default. Mutually exclusive with event_id.","schema":{"type":"string","enum":["NBA","NFL","NHL","NCAAF","NCAAB","EPL","MLS","UCL"],"default":"NBA"}},{"name":"event_id","in":"query","description":"Native event ID from a league response. Mutually exclusive with league.","schema":{"type":"string","pattern":"^[1-9][0-9]{0,14}$"}},{"name":"market_id","in":"query","description":"Exact native market ID; requires event_id.","schema":{"type":"string","pattern":"^[1-9][0-9]{0,14}$"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":5000,"default":0}}],"responses":{"200":{"description":"Native priced markets with explicit partial coverage and source clocks. Empty upstream results do not establish universal absence.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","maxItems":100,"items":{"type":"object","properties":{"id":{"type":"string"},"source":{"const":"betrivers"},"bookmaker":{"const":"betrivers"},"jurisdiction":{"const":"US-PA"},"event":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"english_name":{"type":["string","null"]},"home_name":{"type":["string","null"]},"away_name":{"type":["string","null"]},"league":{"description":"Native Kambi group label.","enum":["NBA","NFL","NHL","NCAAF","NCAAB","Premier League","MLS","Champions League"]},"sport":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"state":{"const":"NOT_STARTED"},"participants":{"type":"array","items":{"type":"object"}}}},"criterion":{"type":"object","properties":{"id":{"type":"string"},"label":{"type":"string"},"english_label":{"type":["string","null"]},"lifetime":{"type":["string","null"]},"occurrence_type":{"type":["string","null"]},"occurrence_number":{"type":["number","null"]},"race_to_value":{"type":["number","null"]}}},"market_type":{"type":"object"},"tags":{"type":"array","items":{"type":"string"}},"scheduled_close_at":{"type":["string","null"],"format":"date-time"},"outcomes":{"type":"array","maxItems":200,"items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"english_name":{"type":["string","null"]},"native_type":{"type":["string","null"]},"side":{"type":["string","null"]},"line":{"type":["number","null"]},"participant_name":{"type":["string","null"]},"participant_id":{"type":["string","null"]},"status":{"const":"OPEN"},"price_decimal":{"type":"number","exclusiveMinimum":1},"price_american":{"type":["integer","null"]},"source_updated_at":{"type":["string","null"],"format":"date-time"},"observed_at":{"type":"string","format":"date-time"}}}},"listed_outcome_count":{"type":"integer"},"returned_outcome_count":{"type":"integer"},"partial_outcomes":{"type":"boolean"},"observed_at":{"type":"string","format":"date-time"}}}},"coverage":{"type":"object","description":"Native events/markets, eligible priced counts, and explicit exclusions."},"meta":{"type":"object","properties":{"source":{"const":"betrivers"},"bookmaker":{"const":"betrivers"},"jurisdiction":{"const":"US-PA"},"provider":{"const":"Kambi"},"brand":{"const":"rsi2uspa"},"upstream_url":{"type":"string"},"requested_at":{"type":"string","format":"date-time"},"observed_at":{"type":"string","format":"date-time"},"upstream_http_date":{"type":["string","null"]},"upstream_cache_age_seconds":{"type":["number","null"]},"scope":{"enum":["native_event_offers","league_list_offers"]},"complete":{"const":false},"capture_complete":{"const":false},"snapshot_consistent":{"const":false},"market_contract_comparability":{"const":false},"price_format_semantics":{"type":"string"},"source_updated_at_semantics":{"type":"string"},"period_semantics":{"type":"string"},"scheduled_close_at_semantics":{"type":"string"}}},"pagination":{"type":"object","properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}}}}}}},"400":{"description":"Invalid query, denied grant/selection, quota, unsupported bounded response, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid query, denied grant/selection, quota, unsupported bounded response, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Invalid query, denied grant/selection, quota, unsupported bounded response, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid query, denied grant/selection, quota, unsupported bounded response, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Invalid query, denied grant/selection, quota, unsupported bounded response, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid query, denied grant/selection, quota, unsupported bounded response, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Invalid query, denied grant/selection, quota, unsupported bounded response, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/pinnacle/markets":{"get":{"operationId":"listPinnacleMarkets","summary":"Read Pinnacle pregame prices (moneyline, spread, total, team total, specials incl. NFL player props)","description":"Open to every valid key; one credit per successful page. Read through from Pinnacle's public guest API at request time and reused for at most 20 seconds per league; nothing is stored, so there is no Pinnacle history. Pregame open markets only. Pinnacle is an international book, not a US-licensed sportsbook.","security":[{"bearerKey":[]}],"parameters":[{"name":"league","in":"query","schema":{"type":"string","enum":["NFL","NCAAF","NBA","NCAAB","NHL","EPL","MLS","UCL","BUNDESLIGA"],"default":"NFL"}},{"name":"market","in":"query","schema":{"type":"string","enum":["moneyline","spread","total","team_total","special"]}},{"name":"matchup_id","in":"query","description":"A game matchup_id; also returns that game's props.","schema":{"type":"string","pattern":"^[1-9][0-9]{0,14}$"}},{"name":"alternates","in":"query","description":"Include alternate spreads and totals.","schema":{"type":"boolean","default":false}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":5000,"default":0}}],"responses":{"200":{"description":"Pregame priced markets with explicit coverage counts.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","maxItems":200,"items":{"type":"object","properties":{"id":{"type":"string"},"source":{"const":"pinnacle"},"bookmaker":{"const":"pinnacle"},"league":{"enum":["NFL","NCAAF","NBA","NCAAB","NHL","EPL","MLS","UCL","BUNDESLIGA"]},"matchup_id":{"type":"string"},"game_matchup_id":{"type":"string"},"home":{"type":["string","null"]},"away":{"type":["string","null"]},"starts_at":{"type":"string","format":"date-time"},"market":{"enum":["moneyline","spread","total","team_total","special"]},"native_market_type":{"type":"string"},"period":{"type":"integer"},"is_alternate":{"type":"boolean"},"special":{"type":["object","null"],"properties":{"category":{"type":["string","null"]},"description":{"type":"string"},"units":{"type":["string","null"]}}},"outcomes":{"type":"array","items":{"type":"object","properties":{"side":{"type":["string","null"]},"participant_id":{"type":["string","null"]},"line":{"type":["number","null"]},"price_american":{"type":"integer"},"price_decimal":{"type":"number","exclusiveMinimum":1}}}},"max_risk_stake":{"type":["number","null"]},"upstream_version":{"type":["number","null"]},"cutoff_at":{"type":"string","format":"date-time"},"observed_at":{"type":"string","format":"date-time"}}}},"coverage":{"type":"object"},"meta":{"type":"object","properties":{"source":{"const":"pinnacle"},"observed_at":{"type":"string","format":"date-time"},"history":{"const":false},"complete":{"const":false}}},"pagination":{"type":"object","properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}},"request_id":{"type":"string"}}}}}},"400":{"description":"Invalid query, invalid key, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid query, invalid key, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid query, invalid key, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Invalid query, invalid key, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid query, invalid key, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Invalid query, invalid key, quota, unsupported upstream data, or unavailable upstream.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/prediction-markets":{"get":{"operationId":"listPredictionMarkets","summary":"Kalshi and Polymarket player-prop contracts normalized next to sportsbook prices","description":"Available to every GetOdds key, one credit per successful page. Best ask per side in dollars per $1 contract, converted to implied probability, American and decimal odds; the venue no-vig probability when both sides are stored; matched BetRivers US-PA prices for the same player, stat and line; and edge_vs_sportsbook_no_vig. Only scopes captured in the last 30 minutes. Kalshi and Polymarket also publish free official APIs.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"type":"string","enum":["kalshi","polymarket"],"default":"kalshi"}},{"name":"league","in":"query","schema":{"type":"string","enum":["NBA","NFL","NHL"]}},{"name":"player","in":"query","description":"Exact player name, case-insensitive.","schema":{"type":"string","maxLength":80}},{"name":"stat","in":"query","description":"Exact stat label, e.g. Points, Rebounds, 3-PT Made, Receiving Yards, Goals.","schema":{"type":"string","maxLength":80}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":5000,"default":0}}],"responses":{"200":{"description":"Possibly empty page; empty does not prove the venue lists nothing.","content":{"application/json":{"schema":{"type":"object","properties":{"request_id":{"type":"string","format":"uuid"},"data":{"type":"array","maxItems":200,"items":{"type":"object","properties":{"id":{"type":"string"},"source":{"enum":["kalshi","polymarket"]},"venue":{"type":"string"},"league":{"type":["string","null"]},"event":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]},"starts_at":{"type":["string","null"],"format":"date-time"},"scheduled_date":{"type":["string","null"]},"name_source":{"enum":["prediction_market","matched_by_player",null]}}},"player":{"type":"string"},"stat":{"type":"string"},"line":{"type":"number"},"side":{"enum":["over","under"]},"contract_side":{"type":["string","null"]},"contract_type":{"type":["string","null"]},"price":{"type":"object","properties":{"probability":{"type":"number"},"decimal":{"type":["number","null"]},"american":{"type":["integer","null"]},"basis":{"const":"best_ask_per_1_dollar_contract"}}},"market_no_vig_probability":{"type":["number","null"]},"sportsbook":{"type":["object","null"],"properties":{"bookmaker":{"const":"betrivers"},"jurisdiction":{"const":"US-PA"},"over_american":{"type":["number","null"]},"under_american":{"type":["number","null"]},"implied_probability":{"type":["number","null"]},"no_vig_probability":{"type":["number","null"]},"observed_at":{"type":["string","null"],"format":"date-time"}}},"edge_vs_sportsbook_no_vig":{"type":["number","null"]},"source_updated_at":{"type":["string","null"],"format":"date-time"},"changed_at":{"type":["string","null"],"format":"date-time"},"observed_at":{"type":["string","null"],"format":"date-time"}}}},"pagination":{"type":"object","properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}},"meta":{"type":"object"}}}}}},"400":{"description":"Invalid query, invalid key, quota, unsupported stored row, or unavailable store.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid query, invalid key, quota, unsupported stored row, or unavailable store.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid query, invalid key, quota, unsupported stored row, or unavailable store.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Invalid query, invalid key, quota, unsupported stored row, or unavailable store.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid query, invalid key, quota, unsupported stored row, or unavailable store.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/prediction-markets/history":{"get":{"operationId":"listPredictionMarketHistory","summary":"Stored price changes for one Kalshi or Polymarket contract","description":"Newest first, last 14 days, one credit per page. One row per stored change; gaps mean no stored change.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"type":"string","enum":["kalshi","polymarket"],"default":"kalshi"}},{"name":"id","in":"query","required":true,"schema":{"type":"string","pattern":"^[0-9a-f]{8,64}$"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":200}}],"responses":{"200":{"description":"Stored changes.","content":{"application/json":{"schema":{"type":"object","properties":{"request_id":{"type":"string","format":"uuid"},"data":{"type":"array","items":{"type":"object","properties":{"change":{"type":["string","null"]},"probability":{"type":["number","null"]},"american":{"type":["integer","null"]},"source_updated_at":{"type":["string","null"],"format":"date-time"},"observed_at":{"type":["string","null"],"format":"date-time"}}}},"meta":{"type":"object"}}}}}},"400":{"description":"Invalid query, invalid key, quota, unsupported stored row, or unavailable store.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid query, invalid key, quota, unsupported stored row, or unavailable store.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid query, invalid key, quota, unsupported stored row, or unavailable store.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Invalid query, invalid key, quota, unsupported stored row, or unavailable store.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid query, invalid key, quota, unsupported stored row, or unavailable store.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/history/archive":{"get":{"operationId":"getArchivedPriceEvidence","summary":"Read durable imported source price evidence for one event","description":"Requires the selected source grant and bookmaker selection. One credit per successful page. Data exists only after archive activation/import. Native normalized source payloads preserve observed_at separately from recorded_at; missing historical observations are not synthesized. DraftKings retained changes and FanDuel sampled current markets are different evidence classes. Forward record-ID cursor is a decimal string, not a source sequence or frozen pagination snapshot.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"enum":["draftkings","fanduel"],"default":"draftkings"}},{"name":"event_id","in":"query","required":true,"schema":{"type":"string","maxLength":200}},{"name":"from","in":"query","required":true,"schema":{"type":"string","format":"date-time","description":"UTC inclusive source-observation boundary."}},{"name":"to","in":"query","required":true,"schema":{"type":"string","format":"date-time","description":"UTC exclusive boundary; no future end, at most31days after from."}},{"name":"after","in":"query","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,18})$","default":"0"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}}],"responses":{"200":{"description":"Bounded source evidence with capture_complete=false/history_complete=false.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","maxItems":200,"items":{"type":"object","properties":{"id":{"type":"string"},"source":{"enum":["draftkings","fanduel"]},"event_id":{"type":"string"},"offer_id":{"type":"string"},"observed_at":{"type":"string","format":"date-time"},"source_changed_at":{"type":["string","null"],"format":"date-time"},"recorded_at":{"type":"string","format":"date-time"},"provenance":{"enum":["source_retained_change","source_current_snapshot"]},"payload":{"type":"object","description":"Normalized native price evidence, not raw upstream documents."}}}},"meta":{"type":"object"},"pagination":{"type":"object"},"request_id":{"type":"string"}}}}}},"400":{"description":"Invalid query, unauthorized source, disabled/unavailable archive, page too large or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid query, unauthorized source, disabled/unavailable archive, page too large or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Invalid query, unauthorized source, disabled/unavailable archive, page too large or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Invalid query, unauthorized source, disabled/unavailable archive, page too large or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid query, unauthorized source, disabled/unavailable archive, page too large or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid query, unauthorized source, disabled/unavailable archive, page too large or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/history/coverage":{"get":{"operationId":"getPriceArchiveCoverage","summary":"Read source capture activation, coverage gaps and storage budget state","description":"Requires source grant, not price selection. One credit per successful read. Reports at most100 recent execution receipts and policy-derived missing-run intervals, not proof of complete source changes. Uninitialized and scheduled-disabled states are explicit. Evidence size accounting is JSON bytes plus512bytes/row and excludes database/WAL/index overhead.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"enum":["draftkings","fanduel"],"default":"draftkings"}}],"responses":{"200":{"description":"Source-scoped coverage state with explicit incomplete-history semantics."},"400":{"description":"Invalid query, unauthorized source, disabled/unavailable archive, page too large or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid query, unauthorized source, disabled/unavailable archive, page too large or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Invalid query, unauthorized source, disabled/unavailable archive, page too large or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid query, unauthorized source, disabled/unavailable archive, page too large or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid query, unauthorized source, disabled/unavailable archive, page too large or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/settlements":{"get":{"operationId":"getProvisionalResultRevisions","summary":"Read observed provider-result revisions, not official settlements","description":"Requires DraftKings scope. Returns result evidence captured by successful grading requests, newest revision first. No native bookmaker settlement records are available. Empty evidence never means void/pending. Event IDs remain provider-native and observations are not authenticated provider correction notices. One successful read costs one credit.","security":[{"bearerKey":[]}],"parameters":[{"name":"event_id","in":"query","required":true,"schema":{"type":"string","pattern":"^espn-draftkings:espn:(NFL|NBA|NHL|NCAAF|NCAAB|MLB|EPL|MLS):[0-9]{1,20}$"}},{"name":"source","in":"query","schema":{"const":"draftkings"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}}],"responses":{"200":{"description":"Provisional result evidence revisions with explicit official unknown status.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","maxItems":50,"items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"revision":{"type":"integer","minimum":1},"evidence":{"type":"object"},"source_url":{"type":"string","format":"uri"},"observed_at":{"type":"string","format":"date-time"},"created_at":{"type":"string","format":"date-time"},"supersedes":{"type":["string","null"],"format":"uuid"}}}},"official_settlements":{"type":"array","maxItems":0},"meta":{"type":"object","properties":{"official_status":{"const":"unverified"},"official_settlement_verified":{"const":false},"record_type":{"const":"observed_provider_result_revision"}}},"request_id":{"type":"string"}}}}}},"400":{"description":"Invalid input, denied access, unavailable evidence or quota.409 means idempotency-body conflict or an older evidence receipt racing a newer one.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid input, denied access, unavailable evidence or quota.409 means idempotency-body conflict or an older evidence receipt racing a newer one.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Invalid input, denied access, unavailable evidence or quota.409 means idempotency-body conflict or an older evidence receipt racing a newer one.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid input, denied access, unavailable evidence or quota.409 means idempotency-body conflict or an older evidence receipt racing a newer one.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid input, denied access, unavailable evidence or quota.409 means idempotency-body conflict or an older evidence receipt racing a newer one.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/settlements/grade":{"post":{"operationId":"assessRetainedSelections","summary":"Provisionally assess retained contracts against verified final scores","description":"DraftKings source grant and selected bookmaker required before contract retrieval. Policy completed-game-score-v1 supports NFL/NBA/NCAAF/NCAAB full-game moneyline, spread and total; integer/half lines only. Counts reported final scores, including any overtime represented there, without verifying bookmaker overtime/abandonment/void rules. Ties/equal thresholds produce a computed push, not an official adjudication. Nonstandard final statuses, unsupported contracts and missing retained snapshots are ungradeable. Nonfinal pre/in events are pending. Source failures remain503, never void. Max50 selections from one event per request; JSON body max32KiB. Required customer-scoped Idempotency-Key freezes the response for that request body; changed body returns409. Use a new key to observe a newer provider revision. Each successful call, including cached replay, costs one credit and request allowance.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}},{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,128}$"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["event_id","selections"],"properties":{"event_id":{"type":"string","pattern":"^espn-draftkings:espn:(NFL|NBA|NHL|NCAAF|NCAAB|MLB|EPL|MLS):[0-9]{1,20}$"},"selections":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"object","additionalProperties":false,"required":["offer_id"],"properties":{"offer_id":{"type":"string","pattern":"^[-A-Za-z0-9_:]{1,180}$"},"history_seq":{"type":"string","pattern":"^[1-9][0-9]{0,18}$","description":"Optional exact retained history sequence, at most PostgreSQL bigint max. Without it, assess the current stored offer contract."}}}}}}}}},"responses":{"200":{"description":"Computed assessments pinned to an observed result revision. Never official bookmaker settlement.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"object","properties":{"offer_id":{"type":"string"},"history_seq":{"type":"string"},"contract":{"type":["object","null"],"properties":{"offer_id":{"type":"string"},"event_id":{"type":"string","pattern":"^espn-draftkings:espn:(NFL|NBA|NHL|NCAAF|NCAAB|MLB|EPL|MLS):[0-9]{1,20}$"},"market":{"type":"string"},"period":{"type":"string"},"side":{"type":"string"},"line":{"type":["number","null"]},"observed_at":{"type":"string","format":"date-time"},"history_seq":{"type":["string","null"]}}},"assessment":{"enum":["won","lost","push","pending","ungradeable"]},"reason":{"type":"string"},"official_outcome":{"const":"unknown"},"official_settlement_verified":{"const":false}}}},"idempotency_replayed":{"type":"boolean"},"meta":{"type":"object","properties":{"source":{"const":"draftkings"},"event_id":{"type":"string","pattern":"^espn-draftkings:espn:(NFL|NBA|NHL|NCAAF|NCAAB|MLB|EPL|MLS):[0-9]{1,20}$"},"policy":{"const":"completed-game-score-v1"},"assessment_type":{"const":"provisional_computed"},"official_settlement_verified":{"const":false},"official_void_evidence_available":{"const":false},"evidence_id":{"type":"string","format":"uuid"},"evidence_revision":{"type":"integer","minimum":1},"evidence_observed_at":{"type":"string","format":"date-time","description":"First receipt of the immutable referenced evidence revision."},"assessment_observed_at":{"type":"string","format":"date-time","description":"Provider receipt used for this assessment, possibly newer with unchanged payload."},"provider_update_time":{"type":"null"},"result_available":{"type":"boolean"},"credits":{"const":1}}},"request_id":{"type":"string"}}}}}},"400":{"description":"Invalid input, denied access, unavailable evidence or quota.409 means idempotency-body conflict or an older evidence receipt racing a newer one.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid input, denied access, unavailable evidence or quota.409 means idempotency-body conflict or an older evidence receipt racing a newer one.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Invalid input, denied access, unavailable evidence or quota.409 means idempotency-body conflict or an older evidence receipt racing a newer one.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid input, denied access, unavailable evidence or quota.409 means idempotency-body conflict or an older evidence receipt racing a newer one.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Invalid input, denied access, unavailable evidence or quota.409 means idempotency-body conflict or an older evidence receipt racing a newer one.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid input, denied access, unavailable evidence or quota.409 means idempotency-body conflict or an older evidence receipt racing a newer one.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid input, denied access, unavailable evidence or quota.409 means idempotency-body conflict or an older evidence receipt racing a newer one.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/arbitrage-bets":{"get":{"operationId":"listConditionalArbitrage","summary":"Analyze conditional recent stored-price arbitrage","description":"Requires BOTH draftkings and fanduel key grants AND both selected bookmakers under locked admission before source I/O. One shared credit per successful page. Conditional normal-completed-game analysis only: no verified settlement equivalence, execution, fees, limits or true probabilities. Basketball two-way moneylines; basketball/football matching half-point spreads/totals only. Exact native type allowlists and atomic DraftKings pre-state batch freshness. Full candidate universes matched before filtering/pagination; default exact event starts, explicit bounded_time maximum120s. Collector observation clocks, not live execution quotes. Empty results are bounded sample statements. Unknown/repeated query parameters fail. See /docs/opportunity-feeds.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"type":"string","const":"draftkings","default":"draftkings"}},{"name":"league","in":"query","schema":{"type":"string","enum":["NBA","NCAAB","NFL","NCAAF"]}},{"name":"market","in":"query","schema":{"type":"string","enum":["moneyline","spread","total"]}},{"name":"hours","in":"query","schema":{"type":"integer","minimum":1,"maximum":72,"default":48}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}},{"name":"event_match","in":"query","schema":{"type":"string","enum":["exact","bounded_time"],"default":"exact"},"description":"Explicit bounded_time permits at most120 seconds of schedule difference with full-name and bidirectional uniqueness constraints. Never canonical identity."},{"name":"max_age_seconds","in":"query","schema":{"type":"integer","minimum":30,"maximum":600,"default":600}},{"name":"max_skew_seconds","in":"query","schema":{"type":"integer","minimum":0,"maximum":600,"default":120}},{"name":"min_edge_percent","in":"query","schema":{"type":"number","minimum":0,"maximum":100,"multipleOf":0.0001,"default":0}},{"name":"bankroll","in":"query","schema":{"type":"number","minimum":1,"maximum":1000000,"multipleOf":0.01,"default":100},"description":"Hypothetical USD bankroll; rounded allocations/payouts in cents."},{"name":"all_combinations","in":"query","schema":{"type":"boolean","default":false}}],"responses":{"200":{"description":"Positive conditional results under documented filters; empty data is valid. Inspect policy and coverage.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","maxItems":100,"items":{"type":"object","required":["id","event","market","quotes","computed_at","policy","classification"],"properties":{"id":{"type":"string"},"event":{"type":"object","properties":{"draftkings":{"type":"object"},"fanduel":{"type":"object"},"association":{"enum":["unique_exact_metadata","unique_full_names_bounded_time_not_canonical"]},"start_offset_seconds":{"type":"number"},"maximum_start_offset_seconds":{"enum":[0,120]}}},"market":{"type":"object","properties":{"family":{"enum":["moneyline","spread","total"]},"period":{"const":"game"},"line":{"type":["number","null"]},"sides":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"string"}}}},"quotes":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"object","properties":{"bookmaker":{"enum":["draftkings","fanduel"]},"observed_at":{"type":"string","format":"date-time"},"source_updated_at":{"type":"null"},"american":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"integer"}},"stored_decimals":{"type":"array","items":{"type":"number"}}}}},"observation_gap_seconds":{"type":"number"},"quote_age_seconds":{"type":"object"},"computed_at":{"type":"string","format":"date-time"},"policy":{"const":"completed-normal-game-v1"},"classification":{"const":"conditional_two_outcome_price_arbitrage"},"allocation":{"type":"object","properties":{"stakes_cents":{"type":"array","items":{"type":"integer"}},"payouts_cents":{"type":"array","items":{"type":"integer"}},"minimum_profit_cents":{"type":"integer","minimum":1},"margin_percent":{"type":"number","exclusiveMinimum":0}}},"maximum_stake":{"type":"null"}}}},"meta":{"type":"object","properties":{"policy":{"type":"object","properties":{"version":{"const":"completed-normal-game-v1"},"market_contract_comparability":{"const":false},"guaranteed_profit":{"const":false},"execution_verified":{"const":false},"true_probability_estimated":{"const":false},"assumptions":{"type":"array","items":{"type":"string"}}}},"coverage":{"type":"object"},"filters":{"type":"object"},"empty_result_semantics":{"type":"string"},"snapshot_consistent":{"const":false},"capture_complete":{"const":false}}},"pagination":{"type":"object","properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}}}}}}},"400":{"description":"Invalid query, denied grants/bookmaker selection, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid query, denied grants/bookmaker selection, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Invalid query, denied grants/bookmaker selection, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Complete candidate universe exceeds bound; narrow hours.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid query, denied grants/bookmaker selection, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid query, denied grants/bookmaker selection, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/value-bets":{"get":{"operationId":"listCrossBookValueReferences","summary":"Compare prices with another book’s no-vig reference","description":"Requires BOTH draftkings and fanduel key grants AND both selected bookmakers under locked admission before source I/O. One shared credit per successful page. Conditional normal-completed-game analysis only: no verified settlement equivalence, execution, fees, limits or true probabilities. Basketball two-way moneylines; basketball/football matching half-point spreads/totals only. Exact native type allowlists and atomic DraftKings pre-state batch freshness. Full candidate universes matched before filtering/pagination; default exact event starts, explicit bounded_time maximum120s. Collector observation clocks, not live execution quotes. Empty results are bounded sample statements. Unknown/repeated query parameters fail. See /docs/opportunity-feeds.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"type":"string","const":"draftkings","default":"draftkings"}},{"name":"league","in":"query","schema":{"type":"string","enum":["NBA","NCAAB","NFL","NCAAF"]}},{"name":"market","in":"query","schema":{"type":"string","enum":["moneyline","spread","total"]}},{"name":"hours","in":"query","schema":{"type":"integer","minimum":1,"maximum":72,"default":48}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}},{"name":"event_match","in":"query","schema":{"type":"string","enum":["exact","bounded_time"],"default":"exact"},"description":"Explicit bounded_time permits at most120 seconds of schedule difference with full-name and bidirectional uniqueness constraints. Never canonical identity."},{"name":"max_age_seconds","in":"query","schema":{"type":"integer","minimum":30,"maximum":600,"default":600}},{"name":"max_skew_seconds","in":"query","schema":{"type":"integer","minimum":0,"maximum":600,"default":120}},{"name":"min_edge_percent","in":"query","schema":{"type":"number","minimum":0,"maximum":100,"multipleOf":0.0001,"default":0}},{"name":"bookmaker","in":"query","schema":{"type":"string","enum":["draftkings","fanduel"],"default":"draftkings"},"description":"Offer source; other book is reference."}],"responses":{"200":{"description":"Positive conditional results under documented filters; empty data is valid. Inspect policy and coverage.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","maxItems":100,"items":{"type":"object","required":["id","event","market","quotes","computed_at","policy","classification"],"properties":{"id":{"type":"string"},"event":{"type":"object","properties":{"draftkings":{"type":"object"},"fanduel":{"type":"object"},"association":{"enum":["unique_exact_metadata","unique_full_names_bounded_time_not_canonical"]},"start_offset_seconds":{"type":"number"},"maximum_start_offset_seconds":{"enum":[0,120]}}},"market":{"type":"object","properties":{"family":{"enum":["moneyline","spread","total"]},"period":{"const":"game"},"line":{"type":["number","null"]},"sides":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"string"}}}},"quotes":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"object","properties":{"bookmaker":{"enum":["draftkings","fanduel"]},"observed_at":{"type":"string","format":"date-time"},"source_updated_at":{"type":"null"},"american":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"integer"}},"stored_decimals":{"type":"array","items":{"type":"number"}}}}},"observation_gap_seconds":{"type":"number"},"quote_age_seconds":{"type":"object"},"computed_at":{"type":"string","format":"date-time"},"policy":{"const":"completed-normal-game-v1"},"classification":{"const":"cross_book_no_vig_reference"},"probability_semantics":{"const":"market_implied_reference_not_true_probability"},"reference_probability":{"type":"number","minimum":0,"maximum":1},"reference_decimal":{"type":"number"},"reference_edge_percent":{"type":"number","exclusiveMinimum":0},"reference_overround_percent":{"type":"number","minimum":0,"maximum":50}}}},"meta":{"type":"object","properties":{"policy":{"type":"object","properties":{"version":{"const":"completed-normal-game-v1"},"market_contract_comparability":{"const":false},"guaranteed_profit":{"const":false},"execution_verified":{"const":false},"true_probability_estimated":{"const":false},"assumptions":{"type":"array","items":{"type":"string"}}}},"coverage":{"type":"object"},"filters":{"type":"object"},"empty_result_semantics":{"type":"string"},"snapshot_consistent":{"const":false},"capture_complete":{"const":false}}},"pagination":{"type":"object","properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}}}}}}},"400":{"description":"Invalid query, denied grants/bookmaker selection, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid query, denied grants/bookmaker selection, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Invalid query, denied grants/bookmaker selection, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Complete candidate universe exceeds bound; narrow hours.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid query, denied grants/bookmaker selection, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid query, denied grants/bookmaker selection, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/mappings":{"get":{"operationId":"listEventMappings","summary":"Read conservative DraftKings-to-FanDuel event metadata associations","description":"Requires BOTH draftkings and fanduel key grants before either source read, but no bookmaker price selection. One credit per successful page. Includes unmatched and ambiguous DraftKings anchors. Only unique exact sport/league and normalized full HOME/AWAY names match, with UTC starts at most 1800 seconds apart (books publish different start clocks for the same game); the same teams repeated within 12 hours require identical starts. Normalization is NFC, lowercase and whitespace only. No aliases or nickname guesses. Native FanDuel team evidence requires two explicit HOME/AWAY runners on non-future game moneylines. This is bounded observed metadata, not canonical identity, comparable market contracts or arbitrage. DraftKings schedule metadata must be observed within 3 hours and FanDuel market metadata within 15 minutes. The entire bounded universe is matched before cursor pagination; clipped candidate sets fail with 422. Repeated/unknown parameters are rejected.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"type":"string","const":"draftkings","default":"draftkings"}},{"name":"league","in":"query","description":"Filter DraftKings anchors. EPL/MLS have no supported native correspondence and remain unmatched.","schema":{"type":"string","enum":["NBA","NFL","NHL","MLB","NCAAB","NCAAF","EPL","MLS"]}},{"name":"hours","in":"query","description":"Future start window beginning at checked_at.","schema":{"type":"integer","minimum":1,"maximum":72,"default":48}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"after","in":"query","description":"Exclusive DraftKings native event ID cursor. Unmatched anchors are included.","schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,180}$"}}],"responses":{"200":{"description":"Source-observed associations, including unmatched/ambiguous records. Empty data is valid; it does not establish upstream emptiness.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","maxItems":100,"items":{"type":"object","properties":{"draftkings_event":{"type":"object","properties":{"id":{"type":"string"},"sport":{"type":"string"},"league":{"type":"string"},"home":{"type":["string","null"]},"away":{"type":["string","null"]},"starts_at":{"type":"string","format":"date-time"},"observed_at":{"type":"string","format":"date-time"}}},"state":{"enum":["matched","unmatched","ambiguous"]},"reason":{"type":"string"},"fanduel_event_id":{"type":["string","null"]},"evidence":{"type":"object","properties":{"match_key":{"type":["object","null"]},"candidate_count":{"type":"integer"},"candidate_ids":{"type":"array","maxItems":10,"items":{"type":"string"}},"candidates_truncated":{"type":"boolean"},"competing_anchor_count":{"type":"integer"},"start_offset_seconds":{"type":["number","null"]},"start_tolerance_seconds":{"type":"integer"},"repeated_teams_strict":{"type":"boolean"},"native_market_ids":{"type":"array","maxItems":10,"items":{"type":"string"}},"native_market_ids_truncated":{"type":"boolean"},"fanduel_observed_at":{"type":["string","null"],"format":"date-time"}}}}}},"meta":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"string"}},"checked_at":{"type":"string","format":"date-time"},"canonical_identity":{"const":false},"market_contract_comparability":{"const":false},"capture_complete":{"const":false},"snapshot_consistent":{"const":false}}},"pagination":{"type":"object","properties":{"limit":{"type":"integer"},"has_more":{"type":"boolean"},"next_after":{"type":["string","null"]}}},"request_id":{"type":"string"}}}}}},"400":{"description":"Invalid request, denied source grants, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid request, denied source grants, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Invalid request, denied source grants, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Candidate universe clipped: narrow the window or anchor league.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid request, denied source grants, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid request, denied source grants, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/historical/closing-lines":{"get":{"operationId":"getObservedPreStartLines","summary":"Read last retained offer snapshots before the stored scheduled start","description":"DraftKings grant and selected bookmaker required. One credit per successful page. Selects the last retained price per market, period and side observed strictly before the current stored scheduled start, within lookback_hours (default 48, max 168), over history that is kept, not aged out. History stores price changes only, so each row reports closed_at and minutes_before_start, and meta.last_collected_at is the last collector pass for the event before start. Superseded spread/total lines are excluded. Ties use greatest sequence. Not an official closing price or verified actual kickoff. No stale substitution, jurisdiction guarantee, complete capture, settlement or value signal. Future scheduled start returns409; known event without eligible history returns200 with empty data.","security":[{"bearerKey":[]}],"parameters":[{"name":"event_id","in":"query","required":true,"schema":{"type":"string","pattern":"^espn-draftkings:espn:(NBA|NFL|NHL|NCAAF|NCAAB|MLB|EPL|MLS):[0-9]{1,20}$"}},{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}},{"name":"market","in":"query","schema":{"enum":["moneyline","spread","total"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}},{"name":"lookback_hours","in":"query","description":"How far before the stored start a closing price may have been set.","schema":{"type":"integer","minimum":1,"maximum":168,"default":48}}],"responses":{"200":{"description":"Bounded observations; empty does not imply a missing/void market.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","pagination","request_id"],"properties":{"request_id":{"type":"string"},"data":{"type":"array","maxItems":200,"items":{"type":"object","properties":{"offer_id":{"type":"string"},"event_id":{"type":"string"},"seq":{"type":"string","pattern":"^[1-9][0-9]{0,18}$"},"sport":{"type":"string"},"market":{"enum":["moneyline","spread","total"]},"period":{"type":"string"},"side":{"type":"string"},"line":{"type":["number","null"]},"american":{"type":"integer"},"decimal":{"type":"number"},"observed_at":{"type":"string","format":"date-time"},"source_updated_at":{"type":["string","null"],"format":"date-time"},"cutoff":{"type":"string","format":"date-time"},"closed_at":{"type":"string","format":"date-time"},"minutes_before_start":{"type":"number","exclusiveMinimum":0,"maximum":10080},"lag_seconds":{"type":"number","exclusiveMinimum":0,"maximum":604800},"closing_verified":{"const":false}}}},"meta":{"type":"object","properties":{"source":{"const":"draftkings"},"cutoff":{"type":"string","format":"date-time"},"cutoff_semantics":{"type":"string"},"schedule_observed_at":{"type":"string","format":"date-time"},"schedule_history_available":{"const":false},"window_start":{"type":"string","format":"date-time"},"available_window_start":{"type":["string","null"],"format":"date-time"},"retained_window_start":{"type":"string","format":"date-time"},"window_within_retention":{"type":"boolean"},"history_window_days":{"type":"null","description":"History is kept, not a rolling window."},"history_retention":{"const":"kept_forever"},"history_kept_since":{"type":"string","format":"date-time"},"lookback_hours":{"type":"integer","minimum":1,"maximum":168},"pre_start_window_minutes":{"type":"integer","minimum":60,"maximum":10080},"last_collected_at":{"type":["string","null"],"format":"date-time"},"collected_minutes_before_start":{"type":["number","null"]},"oldest_minutes_before_start":{"type":["number","null"]},"history_semantics":{"type":"string"},"availability":{"enum":["observed","no_matching_observations_on_page","outside_retention"]},"closing_verified":{"const":false},"capture_complete":{"const":false},"actual_start_verified":{"const":false},"jurisdiction_available":{"const":false},"official_closing_price":{"const":false},"snapshot_consistent":{"const":false},"row_semantics":{"type":"string"}}},"pagination":{"type":"object","properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}}}}}}},"400":{"description":"Invalid query/scope, missing retained event, future scheduled start, exhausted allowance or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid query/scope, missing retained event, future scheduled start, exhausted allowance or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Invalid query/scope, missing retained event, future scheduled start, exhausted allowance or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid query/scope, missing retained event, future scheduled start, exhausted allowance or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Invalid query/scope, missing retained event, future scheduled start, exhausted allowance or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid query/scope, missing retained event, future scheduled start, exhausted allowance or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid query/scope, missing retained event, future scheduled start, exhausted allowance or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/participants/{id}/logo":{"get":{"operationId":"getParticipantLogo","summary":"Read a verified ESPN participant PNG logo","security":[{"bearerKey":[]}],"description":"Requires DraftKings bearer scope and event_id. Verifies retained event and provider participant before following a provider-supplied default PNG URL on the exact ESPN CDN allowlist. No guessed URLs, redirects or credential forwarding. One successful request costs one credit; no bookmaker price selection required. Images bounded to1MiB and2048px per dimension; both source fetches have5-second deadlines. Missing supported logo returns404; source failure returns503.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^espn:(NBA|NFL|NHL|NCAAF|NCAAB|MLB|EPL|MLS):team:[0-9]{1,20}$"}},{"name":"event_id","in":"query","required":true,"schema":{"type":"string","description":"Retained espn-draftkings:espn:LEAGUE:ID event from the same league."}},{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}}],"responses":{"200":{"description":"Validated source PNG bytes, not a JSON envelope. Receipt clock does not establish provider freshness.","headers":{"X-GetOdds-Request-Id":{"schema":{"type":"string"}},"X-GetOdds-Source-URL":{"schema":{"type":"string","format":"uri"}},"X-GetOdds-Observed-At":{"schema":{"type":"string","format":"date-time"}}},"content":{"image/png":{"schema":{"type":"string","format":"binary"}}}},"400":{"description":"Invalid input, denied scope, missing retained event/participant/logo, quota or unavailable source image.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid input, denied scope, missing retained event/participant/logo, quota or unavailable source image.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Invalid input, denied scope, missing retained event/participant/logo, quota or unavailable source image.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid input, denied scope, missing retained event/participant/logo, quota or unavailable source image.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid input, denied scope, missing retained event/participant/logo, quota or unavailable source image.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid input, denied scope, missing retained event/participant/logo, quota or unavailable source image.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/events/{id}/result":{"get":{"operationId":"getEventResult","summary":"Read current verified ESPN final-result evidence for a retained event","description":"Requires DraftKings bearer source grant. First verifies persisted event identity, then makes one allowlisted bounded ESPN summary request (5s,2MiB). One successful page costs one credit; no bookmaker price selection needed. Only completed post-state STATUS_FINAL variants produce a result. Other event states return200 with data=[] and result_available=false. Source errors remain errors, never void outcomes. Latest provider snapshot, not correction history or sportsbook settlement.","security":[{"bearerKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^espn-draftkings:espn:(NBA|NFL|NHL|NCAAF|NCAAB|MLB|EPL|MLS):[0-9]{1,20}$"}},{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}}],"responses":{"200":{"description":"Zero or one current provider final result.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","maxItems":1,"items":{"type":"object","properties":{"event_id":{"type":"string"},"native_event_id":{"type":"string"},"league":{"type":"string"},"state":{"const":"post"},"completed":{"const":true},"source_status":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"participants":{"type":"array","minItems":2,"maxItems":2,"items":{"type":"object","properties":{"id":{"type":"string"},"native_id":{"type":"string"},"name":{"type":"string"},"side":{"enum":["home","away"]},"score":{"type":"string","pattern":"^[0-9]{1,9}$","description":"Current provider final score; preserved as a string."},"winner":{"type":["boolean","null"],"description":"Explicit provider flag, null when absent; never derived from score."}}}}}}},"meta":{"type":"object","properties":{"source":{"const":"draftkings"},"metadata_provider":{"const":"espn"},"observed_at":{"type":"string","format":"date-time"},"source_updated_at":{"type":"null"},"receipt_time_is_source_freshness":{"const":false},"result_available":{"type":"boolean"},"source_state":{"type":"string"},"source_status":{"type":"string"},"settlement_verified":{"const":false},"correction_history_available":{"const":false},"bookmaker_void_evidence_available":{"const":false}}},"request_id":{"type":"string"}}}}}},"400":{"description":"Invalid query, missing scope/event, exhausted quota or unavailable/malformed provider evidence.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid query, missing scope/event, exhausted quota or unavailable/malformed provider evidence.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Invalid query, missing scope/event, exhausted quota or unavailable/malformed provider evidence.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Invalid query, missing scope/event, exhausted quota or unavailable/malformed provider evidence.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid query, missing scope/event, exhausted quota or unavailable/malformed provider evidence.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid query, missing scope/event, exhausted quota or unavailable/malformed provider evidence.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/events/live":{"get":{"operationId":"listObservedLiveEvents","summary":"Read recently observed FanDuel in-play game events","description":"Requires FanDuel bearer scope, not price selection. One credit per successful page. Only non-future open/suspended markets observed in play within the past15 minutes, never future-dated. This is recent observation evidence, not assurance an event is currently live. Missing events are not inferred complete. Metadata comes from latest qualifying market; metadata_ambiguous flags disagreement among qualifying records. Native IDs only, no prices or result inference. String filters are exact and case sensitive.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"const":"fanduel","default":"fanduel"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"event_id","in":"query","schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,180}$"},"description":"Native event ID; after sorts bytewise."},{"name":"after","in":"query","schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,180}$"},"description":"Native event ID; after sorts bytewise."},{"name":"league","in":"query","schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,180}$"},"description":"Exact collector league, e.g. NFL or NBA."},{"name":"sport","in":"query","schema":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,180}$"},"description":"Exact collector sport, e.g. football or basketball."}],"responses":{"200":{"description":"Bounded source-native observations; empty data is valid.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","maxItems":100,"items":{"type":"object","properties":{"id":{"type":"string"},"sport":{"type":"string"},"league":{"type":"string"},"name":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"observed_in_play":{"const":true},"metadata_ambiguous":{"type":"boolean"},"qualifying_market_observed_at":{"type":"string","format":"date-time"},"qualifying_market_changed_at":{"type":"string","format":"date-time"},"event_read_at":{"type":["string","null"],"format":"date-time"}}}},"meta":{"type":"object"},"pagination":{"type":"object","properties":{"limit":{"type":"integer"},"has_more":{"type":"boolean"},"next_after":{"type":["string","null"]},"snapshot_consistent":{"const":false}}},"request_id":{"type":"string"}}}}}},"400":{"description":"Invalid filter, denied scope, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid filter, denied scope, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Invalid filter, denied scope, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid filter, denied scope, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid filter, denied scope, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/sportsbook/markets":{"get":{"operationId":"listFanDuelSportsbookMarkets","summary":"Read stored FanDuel game markets","security":[{"bearerKey":[]}],"description":"Stored FanDuel current records with native identities and literal clocks. Requires FanDuel key scope and selected bookmaker. One successful page costs one credit. after is the last native market ID, sorted bytewise, not a change cursor or frozen snapshot. Statuses and null prices are preserved; open status alone does not prove current freshness. No cross-book matching or complete-capture guarantee.","parameters":[{"name":"source","in":"query","schema":{"const":"fanduel","default":"fanduel"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"after","in":"query","schema":{"type":"string","maxLength":180,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"event_id","in":"query","schema":{"type":"string","maxLength":180,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"market_id","in":"query","schema":{"type":"string","maxLength":180,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"league","in":"query","schema":{"type":"string","maxLength":180,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"family","in":"query","schema":{"type":"string","maxLength":180,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"status","in":"query","schema":{"enum":["open","suspended","closed","removed"]}}],"responses":{"200":{"description":"Stored markets with all stored selection prices.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","maxItems":100,"items":{"type":"object","properties":{"id":{"type":"string"},"event_id":{"type":"string","description":"FanDuel native event or futures-board ID, not a canonical cross-book event."},"sport":{"type":"string"},"league":{"type":"string"},"event_name":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"is_future":{"type":"boolean"},"family":{"type":"string"},"fanduel_type":{"type":"string"},"name":{"type":"string"},"period":{"type":"string"},"player":{"type":["string","null"]},"line":{"type":["number","null"]},"in_play":{"type":"boolean"},"market_status":{"enum":["open","suspended","closed","removed"]},"hold":{"type":["number","null"]},"first_seen_at":{"type":"string","format":"date-time"},"changed_at":{"type":"string","format":"date-time"},"observed_at":{"type":"string","format":"date-time"},"event_read_at":{"type":["string","null"],"format":"date-time"},"selections":{"type":"array","maxItems":1000,"items":{"type":"object","required":["id","name","side","line","player","team","american","decimal","status","fair"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"side":{"type":["string","null"]},"line":{"type":["number","null"]},"player":{"type":["string","null"]},"team":{"type":["string","null"]},"american":{"type":["number","null"]},"decimal":{"type":["number","null"]},"status":{"enum":["active","suspended"]},"fair":{"type":["number","null"],"description":"Source collector calculated no-vig probability, nullable; not a cross-book fair price."}}}}}}},"meta":{"type":"object"},"pagination":{"type":"object","properties":{"limit":{"type":"integer"},"has_more":{"type":"boolean"},"next_after":{"type":["string","null"]},"snapshot_consistent":{"const":false}}},"request_id":{"type":"string","format":"uuid"}}}}}},"400":{"description":"Invalid request, denied access, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid request, denied access, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Invalid request, denied access, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Reduce limit; bounded response is too large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid request, denied access, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid request, denied access, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/outrights":{"get":{"operationId":"listFanDuelOutrights","summary":"Discover stored FanDuel futures markets","security":[{"bearerKey":[]}],"description":"Stored FanDuel current records with native identities and literal clocks. Requires FanDuel key scope and selected bookmaker. One successful page costs one credit. after is the last native market ID, sorted bytewise, not a change cursor or frozen snapshot. Statuses and null prices are preserved; open status alone does not prove current freshness. No cross-book matching or complete-capture guarantee.","parameters":[{"name":"source","in":"query","schema":{"const":"fanduel","default":"fanduel"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"after","in":"query","schema":{"type":"string","maxLength":180,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"event_id","in":"query","schema":{"type":"string","maxLength":180,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"market_id","in":"query","schema":{"type":"string","maxLength":180,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"league","in":"query","schema":{"type":"string","maxLength":180,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"family","in":"query","schema":{"type":"string","maxLength":180,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"status","in":"query","schema":{"enum":["open","suspended","closed","removed"]}}],"responses":{"200":{"description":"Futures market metadata; selections and hold omitted.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","maxItems":100,"items":{"type":"object","properties":{"id":{"type":"string"},"event_id":{"type":"string","description":"FanDuel native event or futures-board ID, not a canonical cross-book event."},"sport":{"type":"string"},"league":{"type":"string"},"event_name":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"is_future":{"type":"boolean"},"family":{"type":"string"},"fanduel_type":{"type":"string"},"name":{"type":"string"},"period":{"type":"string"},"player":{"type":["string","null"]},"line":{"type":["number","null"]},"in_play":{"type":"boolean"},"market_status":{"enum":["open","suspended","closed","removed"]},"first_seen_at":{"type":"string","format":"date-time"},"changed_at":{"type":"string","format":"date-time"},"observed_at":{"type":"string","format":"date-time"},"event_read_at":{"type":["string","null"],"format":"date-time"},"selection_count":{"type":"integer"}}}},"meta":{"type":"object"},"pagination":{"type":"object","properties":{"limit":{"type":"integer"},"has_more":{"type":"boolean"},"next_after":{"type":["string","null"]},"snapshot_consistent":{"const":false}}},"request_id":{"type":"string","format":"uuid"}}}}}},"400":{"description":"Invalid request, denied access, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid request, denied access, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Invalid request, denied access, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Reduce limit; bounded response is too large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid request, denied access, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid request, denied access, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/outrights/odds":{"get":{"operationId":"listFanDuelOutrightOdds","summary":"Read stored FanDuel futures selection prices","security":[{"bearerKey":[]}],"description":"Stored FanDuel current records with native identities and literal clocks. Requires FanDuel key scope and selected bookmaker. One successful page costs one credit. after is the last native market ID, sorted bytewise, not a change cursor or frozen snapshot. Statuses and null prices are preserved; open status alone does not prove current freshness. No cross-book matching or complete-capture guarantee.","parameters":[{"name":"source","in":"query","schema":{"const":"fanduel","default":"fanduel"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"name":"after","in":"query","schema":{"type":"string","maxLength":180,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"event_id","in":"query","schema":{"type":"string","maxLength":180,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"market_id","in":"query","schema":{"type":"string","maxLength":180,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"league","in":"query","schema":{"type":"string","maxLength":180,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"family","in":"query","schema":{"type":"string","maxLength":180,"pattern":"^[A-Za-z0-9_.:-]+$"}},{"name":"status","in":"query","schema":{"enum":["open","suspended","closed","removed"]}}],"responses":{"200":{"description":"Stored markets with all stored selection prices.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","maxItems":100,"items":{"type":"object","properties":{"id":{"type":"string"},"event_id":{"type":"string","description":"FanDuel native event or futures-board ID, not a canonical cross-book event."},"sport":{"type":"string"},"league":{"type":"string"},"event_name":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"is_future":{"type":"boolean"},"family":{"type":"string"},"fanduel_type":{"type":"string"},"name":{"type":"string"},"period":{"type":"string"},"player":{"type":["string","null"]},"line":{"type":["number","null"]},"in_play":{"type":"boolean"},"market_status":{"enum":["open","suspended","closed","removed"]},"hold":{"type":["number","null"]},"first_seen_at":{"type":"string","format":"date-time"},"changed_at":{"type":"string","format":"date-time"},"observed_at":{"type":"string","format":"date-time"},"event_read_at":{"type":["string","null"],"format":"date-time"},"selections":{"type":"array","maxItems":1000,"items":{"type":"object","required":["id","name","side","line","player","team","american","decimal","status","fair"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"side":{"type":["string","null"]},"line":{"type":["number","null"]},"player":{"type":["string","null"]},"team":{"type":["string","null"]},"american":{"type":["number","null"]},"decimal":{"type":["number","null"]},"status":{"enum":["active","suspended"]},"fair":{"type":["number","null"],"description":"Source collector calculated no-vig probability, nullable; not a cross-book fair price."}}}}}}},"meta":{"type":"object"},"pagination":{"type":"object","properties":{"limit":{"type":"integer"},"has_more":{"type":"boolean"},"next_after":{"type":["string","null"]},"snapshot_consistent":{"const":false}}},"request_id":{"type":"string","format":"uuid"}}}}}},"400":{"description":"Invalid request, denied access, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid request, denied access, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Invalid request, denied access, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Reduce limit; bounded response is too large.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid request, denied access, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Invalid request, denied access, quota or unavailable source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/odds/stream":{"get":{"operationId":"streamRetainedOdds","summary":"Stream bounded retained-change pages over authenticated WebSocket","description":"Actual WebSocket upgrade on the Node/Fluid runtime. Server-side clients must send Authorization: Bearer; credentials in URLs and cookie-only authentication are not supported. Uses the replay cursor/filter contract, polling retained changes every five seconds. Upgrade admission costs zero credits; each successful poll/page costs one shared credit, including empty polls, and consumes shared request allowance. Maximum two active connections per customer across keys; each closes after at most 240 seconds with 1012. Every poll rechecks revocation, scope, account bookmaker selection and lease. This does not change source collection frequency or guarantee complete capture. Save after/through only after processing every row in a received page; reconnect from that client checkpoint. No application messages are accepted.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}},{"name":"after","in":"query","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,18})$","description":"Canonical decimal bigint string, at most 9223372036854775807. Never convert to a JavaScript Number.","default":"0"}},{"name":"through","in":"query","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,18})$","description":"Canonical decimal bigint string, at most 9223372036854775807. Never convert to a JavaScript Number."}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"event_ids","in":"query","schema":{"type":"string","description":"Optional comma-separated list of1–20 distinct source event IDs."}},{"name":"sport","in":"query","schema":{"type":"string","enum":["NFL","NBA","NHL","NCAAF","NCAAB","MLB","EPL","MLS"]}},{"name":"market","in":"query","schema":{"type":"string","enum":["moneyline","spread","total"]}}],"responses":{"101":{"description":"WebSocket connected. JSON text frames follow the documented getodds-retained-odds-v1 protocol."},"400":{"description":"Invalid request, missing access or unavailable retained source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid request, missing access or unavailable retained source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Invalid request, missing access or unavailable retained source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"426":{"description":"A WebSocket upgrade is required; this is not SSE or a long-poll HTTP response."},"429":{"description":"Invalid request, missing access or unavailable retained source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"503":{"description":"Invalid request, missing access or unavailable retained source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-websocket-protocol":{"name":"getodds-retained-odds-v1","incoming_application_messages":false,"max_incoming_message_bytes":1024,"max_outgoing_frame_bytes":1048576,"max_connections_per_customer":2,"source_poll_interval_ms":5000,"max_session_duration_ms":240000,"frames":{"welcome":{"description":"Protocol and accounting boundaries, not source freshness."},"changes":{"allOf":[{"type":"object","required":["data","meta","pagination","request_id"],"properties":{"data":{"type":"array","maxItems":200,"items":{"type":"object","required":["seq","offer_id","event_id","sport","market","period","side","line","american","decimal","observed_at","source_updated_at","age_seconds","stale"],"properties":{"seq":{"type":"string","pattern":"^(0|[1-9][0-9]{0,18})$","description":"Canonical decimal bigint string, at most 9223372036854775807. Never convert to a JavaScript Number."},"offer_id":{"type":"string"},"event_id":{"type":"string"},"sport":{"type":"string"},"market":{"enum":["moneyline","spread","total"]},"period":{"type":"string"},"side":{"type":"string"},"line":{"type":["number","null"]},"american":{"type":"integer"},"decimal":{"type":"number","exclusiveMinimum":1},"observed_at":{"type":"string","format":"date-time"},"source_updated_at":{"type":["string","null"],"format":"date-time"},"age_seconds":{"type":"integer","minimum":0},"stale":{"type":"boolean"}}}},"meta":{"type":"object","properties":{"source":{"const":"draftkings"},"transport":{"const":"stored_espn_draftkings"},"checked_at":{"type":"string","format":"date-time"},"history_window_days":{"type":"null","description":"History is kept, not a rolling window."},"history_retention":{"const":"kept_forever"},"window_start":{"type":"string","format":"date-time"},"retained_min_seq":{"type":["string","null"]},"retained_max_seq":{"type":["string","null"]},"source_capture_complete":{"const":false},"deletion_events_available":{"const":false},"arbitrary_gap_detection":{"const":false},"snapshot_consistent":{"const":false},"watermark_semantics":{"type":"string"},"row_semantics":{"const":"retained_offer_snapshot_on_change"},"filters":{"type":"object","required":["event_ids","sport","market"],"properties":{"event_ids":{"type":"array","maxItems":20,"items":{"type":"string"}},"sport":{"type":["string","null"]},"market":{"type":["string","null"]}}}}},"pagination":{"type":"object","required":["limit","after","through","has_more","next_after","replay_complete"],"properties":{"limit":{"type":"integer"},"after":{"type":"string","pattern":"^(0|[1-9][0-9]{0,18})$","description":"Canonical decimal bigint string, at most 9223372036854775807. Never convert to a JavaScript Number."},"through":{"type":"string","pattern":"^(0|[1-9][0-9]{0,18})$","description":"Canonical decimal bigint string, at most 9223372036854775807. Never convert to a JavaScript Number."},"has_more":{"type":"boolean"},"next_after":{"type":"string","pattern":"^(0|[1-9][0-9]{0,18})$","description":"Canonical decimal bigint string, at most 9223372036854775807. Never convert to a JavaScript Number."},"replay_complete":{"type":"boolean"}}},"request_id":{"type":"string","format":"uuid"}}},{"type":"object","required":["type"],"properties":{"type":{"const":"changes"}}}]},"checkpoint":{"description":"Same replay envelope with no matching changes. Process it before advancing the checkpoint."},"replay_complete":{"description":"Initial bounded catch-up finished; subsequent pages continue polling new retained changes."},"resync_required":{"description":"A retained anchor is unavailable. Stop reconnecting unchanged; restart deliberately from after=0."},"error":{"description":"Public error code/status/message; 429 includes retry_after=60."}},"close_codes":{"1008":"Invalid/revoked authorization, selection removed, unsupported application message or expired replay anchor; inspect error and correct before reconnect.","1009":"Incoming message exceeds the limit.","1011":"Source or transport failure; reconnect with backoff and your processed checkpoint.","1012":"Session duration/lease ended; reconnect from your processed checkpoint.","1013":"Quota or slow client; back off and resume from the processed checkpoint."}}}},"/api/v1/odds/replay":{"get":{"operationId":"replayRetainedOdds","summary":"Resume bounded retained offer changes by sequence","description":"One source-scoped SQL snapshot per request. First request uses after=0 and omits through to capture the current upper source sequence. Continue with next_after and the same through/filters until replay_complete, then omit through for the next poll. after/through anchors greater than zero must exist in the retained source history or the response is410 RESYNC_REQUIRED. Numeric sequence holes do not prove missing updates. Upper watermark is not a frozen cross-request snapshot. Capture completeness, arbitrary middle-row deletion detection, lifecycle deletion messages and streaming are not provided. Requires DraftKings scope and account bookmaker selection; one successful page costs one credit.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}},{"name":"after","in":"query","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,18})$","description":"Canonical decimal bigint string, at most 9223372036854775807. Never convert to a JavaScript Number.","default":"0"}},{"name":"through","in":"query","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,18})$","description":"Canonical decimal bigint string, at most 9223372036854775807. Never convert to a JavaScript Number."}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"event_ids","in":"query","schema":{"type":"string","description":"Optional comma-separated list of1–20 distinct source event IDs."}},{"name":"sport","in":"query","schema":{"type":"string","enum":["NFL","NBA","NHL","NCAAF","NCAAB","MLB","EPL","MLS"]}},{"name":"market","in":"query","schema":{"type":"string","enum":["moneyline","spread","total"]}}],"responses":{"200":{"description":"Ascending retained snapshots; empty data is allowed. next_after always provides a decimal-string checkpoint.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","pagination","request_id"],"properties":{"data":{"type":"array","maxItems":200,"items":{"type":"object","required":["seq","offer_id","event_id","sport","market","period","side","line","american","decimal","observed_at","source_updated_at","age_seconds","stale"],"properties":{"seq":{"type":"string","pattern":"^(0|[1-9][0-9]{0,18})$","description":"Canonical decimal bigint string, at most 9223372036854775807. Never convert to a JavaScript Number."},"offer_id":{"type":"string"},"event_id":{"type":"string"},"sport":{"type":"string"},"market":{"enum":["moneyline","spread","total"]},"period":{"type":"string"},"side":{"type":"string"},"line":{"type":["number","null"]},"american":{"type":"integer"},"decimal":{"type":"number","exclusiveMinimum":1},"observed_at":{"type":"string","format":"date-time"},"source_updated_at":{"type":["string","null"],"format":"date-time"},"age_seconds":{"type":"integer","minimum":0},"stale":{"type":"boolean"}}}},"meta":{"type":"object","properties":{"source":{"const":"draftkings"},"transport":{"const":"stored_espn_draftkings"},"checked_at":{"type":"string","format":"date-time"},"history_window_days":{"type":"null","description":"History is kept, not a rolling window."},"history_retention":{"const":"kept_forever"},"window_start":{"type":"string","format":"date-time"},"retained_min_seq":{"type":["string","null"]},"retained_max_seq":{"type":["string","null"]},"source_capture_complete":{"const":false},"deletion_events_available":{"const":false},"arbitrary_gap_detection":{"const":false},"snapshot_consistent":{"const":false},"watermark_semantics":{"type":"string"},"row_semantics":{"const":"retained_offer_snapshot_on_change"},"filters":{"type":"object","required":["event_ids","sport","market"],"properties":{"event_ids":{"type":"array","maxItems":20,"items":{"type":"string"}},"sport":{"type":["string","null"]},"market":{"type":["string","null"]}}}}},"pagination":{"type":"object","required":["limit","after","through","has_more","next_after","replay_complete"],"properties":{"limit":{"type":"integer"},"after":{"type":"string","pattern":"^(0|[1-9][0-9]{0,18})$","description":"Canonical decimal bigint string, at most 9223372036854775807. Never convert to a JavaScript Number."},"through":{"type":"string","pattern":"^(0|[1-9][0-9]{0,18})$","description":"Canonical decimal bigint string, at most 9223372036854775807. Never convert to a JavaScript Number."},"has_more":{"type":"boolean"},"next_after":{"type":"string","pattern":"^(0|[1-9][0-9]{0,18})$","description":"Canonical decimal bigint string, at most 9223372036854775807. Never convert to a JavaScript Number."},"replay_complete":{"type":"boolean"}}},"request_id":{"type":"string","format":"uuid"}}}}}},"400":{"description":"Invalid request, missing access or unavailable retained source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid request, missing access or unavailable retained source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Invalid request, missing access or unavailable retained source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"410":{"description":"RESYNC_REQUIRED: an anchor is expired, deleted, ahead of the source or belongs to another source. Restart with after=0; do not assume unavailable history.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid request, missing access or unavailable retained source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"503":{"description":"Invalid request, missing access or unavailable retained source.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/bookmakers/selected":{"get":{"operationId":"getSelectedBookmakers","summary":"Read permitted account sportsbook selections","description":"Bearer key must grant at least one of draftkings, fanduel or betrivers. GET exposes only the granted subset. Select replaces that entire editable subset and preserves books outside the key grants; clear removes only the editable subset. A single-source key cannot alter selections for other sources. source, when supplied, must be granted but does not narrow the editable subset. Key grants and threshold feeds are never changed. Shared request allowance applies (60/minute, 1,000/UTC day); these management calls cost zero data credits. No payload; actual zero-byte PUT streams are accepted. Unknown/repeated parameters return400; ungranted books return403.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"enum":["draftkings","fanduel","betrivers"]}}],"responses":{"200":{"description":"Account selection intersected with this key’s sportsbook grants. Absent preferences default to DraftKings. Empty visible data does not imply another key’s permitted source is cleared.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","request_id"],"properties":{"data":{"type":"array","maxItems":3,"items":{"type":"object","required":["id","name"],"properties":{"id":{"enum":["draftkings","fanduel","betrivers"]},"name":{"enum":["DraftKings via ESPN","FanDuel","BetRivers Pennsylvania"]}}}},"meta":{"type":"object","required":["scope","bookmakers","selection","updated_at","available_bookmakers","editable_bookmakers","mutation_semantics","affects","changes_key_source_grants","credits"],"properties":{"scope":{"const":"customer"},"bookmakers":{"type":"array","maxItems":3,"uniqueItems":true,"items":{"enum":["draftkings","fanduel","betrivers"]}},"selection":{"enum":["default","explicit"]},"updated_at":{"type":["string","null"],"format":"date-time"},"available_bookmakers":{"type":"array","maxItems":3,"uniqueItems":true,"items":{"enum":["draftkings","fanduel","betrivers"]}},"editable_bookmakers":{"type":"array","maxItems":3,"uniqueItems":true,"items":{"enum":["draftkings","fanduel","betrivers"]}},"mutation_semantics":{"const":"replace editable subset; preserve other source selections"},"affects":{"const":"sportsbook_price_reads"},"changes_key_source_grants":{"const":false},"credits":{"const":0}}},"request_id":{"type":"string","format":"uuid"}}}}}},"400":{"description":"Invalid input, unavailable preference store, missing scope, revoked key or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid input, unavailable preference store, missing scope, revoked key or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Invalid input, unavailable preference store, missing scope, revoked key or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid input, unavailable preference store, missing scope, revoked key or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"503":{"description":"Invalid input, unavailable preference store, missing scope, revoked key or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/bookmakers/selected/select":{"put":{"operationId":"selectBookmakers","summary":"Replace the sportsbook selection subset editable by this key","description":"Bearer key must grant at least one of draftkings, fanduel or betrivers. GET exposes only the granted subset. Select replaces that entire editable subset and preserves books outside the key grants; clear removes only the editable subset. A single-source key cannot alter selections for other sources. source, when supplied, must be granted but does not narrow the editable subset. Key grants and threshold feeds are never changed. Shared request allowance applies (60/minute, 1,000/UTC day); these management calls cost zero data credits. No payload; actual zero-byte PUT streams are accepted. Unknown/repeated parameters return400; ungranted books return403.","security":[{"bearerKey":[]}],"parameters":[{"name":"bookmakers","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated unique draftkings/fanduel/betrivers names, case insensitive. Every requested book must be granted to the key. To retain all three for a fully granted key, provide draftkings,fanduel,betrivers.","examples":["draftkings","fanduel","betrivers","draftkings,fanduel,betrivers"]}},{"name":"source","in":"query","schema":{"enum":["draftkings","fanduel","betrivers"]}}],"responses":{"200":{"description":"Account selection intersected with this key’s sportsbook grants. Absent preferences default to DraftKings. Empty visible data does not imply another key’s permitted source is cleared.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","request_id"],"properties":{"data":{"type":"array","maxItems":3,"items":{"type":"object","required":["id","name"],"properties":{"id":{"enum":["draftkings","fanduel","betrivers"]},"name":{"enum":["DraftKings via ESPN","FanDuel","BetRivers Pennsylvania"]}}}},"meta":{"type":"object","required":["scope","bookmakers","selection","updated_at","available_bookmakers","editable_bookmakers","mutation_semantics","affects","changes_key_source_grants","credits"],"properties":{"scope":{"const":"customer"},"bookmakers":{"type":"array","maxItems":3,"uniqueItems":true,"items":{"enum":["draftkings","fanduel","betrivers"]}},"selection":{"enum":["default","explicit"]},"updated_at":{"type":["string","null"],"format":"date-time"},"available_bookmakers":{"type":"array","maxItems":3,"uniqueItems":true,"items":{"enum":["draftkings","fanduel","betrivers"]}},"editable_bookmakers":{"type":"array","maxItems":3,"uniqueItems":true,"items":{"enum":["draftkings","fanduel","betrivers"]}},"mutation_semantics":{"const":"replace editable subset; preserve other source selections"},"affects":{"const":"sportsbook_price_reads"},"changes_key_source_grants":{"const":false},"credits":{"const":0}}},"request_id":{"type":"string","format":"uuid"}}}}}},"400":{"description":"Invalid input, unavailable preference store, missing scope, revoked key or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid input, unavailable preference store, missing scope, revoked key or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Invalid input, unavailable preference store, missing scope, revoked key or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid input, unavailable preference store, missing scope, revoked key or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"503":{"description":"Invalid input, unavailable preference store, missing scope, revoked key or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/bookmakers/selected/clear":{"put":{"operationId":"clearSelectedBookmakers","summary":"Clear only sportsbook selections editable by this key","description":"Bearer key must grant at least one of draftkings, fanduel or betrivers. GET exposes only the granted subset. Select replaces that entire editable subset and preserves books outside the key grants; clear removes only the editable subset. A single-source key cannot alter selections for other sources. source, when supplied, must be granted but does not narrow the editable subset. Key grants and threshold feeds are never changed. Shared request allowance applies (60/minute, 1,000/UTC day); these management calls cost zero data credits. No payload; actual zero-byte PUT streams are accepted. Unknown/repeated parameters return400; ungranted books return403.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"enum":["draftkings","fanduel","betrivers"]}}],"responses":{"200":{"description":"Account selection intersected with this key’s sportsbook grants. Absent preferences default to DraftKings. Empty visible data does not imply another key’s permitted source is cleared.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","request_id"],"properties":{"data":{"type":"array","maxItems":3,"items":{"type":"object","required":["id","name"],"properties":{"id":{"enum":["draftkings","fanduel","betrivers"]},"name":{"enum":["DraftKings via ESPN","FanDuel","BetRivers Pennsylvania"]}}}},"meta":{"type":"object","required":["scope","bookmakers","selection","updated_at","available_bookmakers","editable_bookmakers","mutation_semantics","affects","changes_key_source_grants","credits"],"properties":{"scope":{"const":"customer"},"bookmakers":{"type":"array","maxItems":3,"uniqueItems":true,"items":{"enum":["draftkings","fanduel","betrivers"]}},"selection":{"enum":["default","explicit"]},"updated_at":{"type":["string","null"],"format":"date-time"},"available_bookmakers":{"type":"array","maxItems":3,"uniqueItems":true,"items":{"enum":["draftkings","fanduel","betrivers"]}},"editable_bookmakers":{"type":"array","maxItems":3,"uniqueItems":true,"items":{"enum":["draftkings","fanduel","betrivers"]}},"mutation_semantics":{"const":"replace editable subset; preserve other source selections"},"affects":{"const":"sportsbook_price_reads"},"changes_key_source_grants":{"const":false},"credits":{"const":0}}},"request_id":{"type":"string","format":"uuid"}}}}}},"400":{"description":"Invalid input, unavailable preference store, missing scope, revoked key or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid input, unavailable preference store, missing scope, revoked key or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Invalid input, unavailable preference store, missing scope, revoked key or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Invalid input, unavailable preference store, missing scope, revoked key or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"503":{"description":"Invalid input, unavailable preference store, missing scope, revoked key or exhausted allowance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/events/{id}/state":{"get":{"operationId":"getEventSourceState","summary":"get Event Source State","description":"One source-reported ESPN state for a known stored DraftKings-via-ESPN event. State and completed are observed directly from ESPN; no cached state fallback, scoring, settlement or independent freshness guarantee. Requires draftkings source grant; one successful read costs one shared credit. One bounded upstream fetch after stored-event verification. No pagination; unknown or repeated query parameters return 400.","security":[{"bearerKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^espn-draftkings:espn:(NBA|NFL|NHL|NCAAF|NCAAB|MLB|EPL|MLS):[0-9]{1,20}$"}},{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}}],"responses":{"200":{"description":"Verified source metadata with explicit identity and timestamp limitations.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","request_id"],"properties":{"data":{"type":"array","maxItems":1,"items":{"type":"object","required":["event_id","native_event_id","league","state","completed","source_status","starts_at"],"properties":{"event_id":{"type":"string"},"native_event_id":{"type":"string"},"league":{"type":"string"},"state":{"enum":["pre","in","post"]},"completed":{"type":"boolean"},"source_status":{"type":"string"},"starts_at":{"type":"string","format":"date-time"}}}},"meta":{"type":"object","required":["source","metadata_provider","transport","source_url","observed_at","source_updated_at","receipt_time_is_source_freshness","canonical_cross_provider_identity","settlement_verified"],"properties":{"source":{"const":"draftkings"},"metadata_provider":{"const":"espn"},"transport":{"const":"live_espn_summary"},"source_url":{"type":"string","format":"uri"},"observed_at":{"type":"string","format":"date-time"},"source_updated_at":{"type":"null"},"receipt_time_is_source_freshness":{"const":false},"canonical_cross_provider_identity":{"const":false},"settlement_verified":{"const":false}}},"request_id":{"type":"string","format":"uuid"}}}}}},"400":{"description":"Request refused, identity missing, or metadata unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Request refused, identity missing, or metadata unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request refused, identity missing, or metadata unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Request refused, identity missing, or metadata unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request refused, identity missing, or metadata unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"500":{"description":"Request refused, identity missing, or metadata unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Request refused, identity missing, or metadata unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/participants":{"get":{"operationId":"getEventParticipants","summary":"get Event Participants","description":"The home and away teams for one known stored event. IDs are ESPN-native and namespaced by league; this is not a global participant directory or cross-book canonical mapping. event_id is required. Requires draftkings source grant; one successful read costs one shared credit. One bounded upstream fetch after stored-event verification. No pagination; unknown or repeated query parameters return 400.","security":[{"bearerKey":[]}],"parameters":[{"name":"event_id","in":"query","required":true,"schema":{"type":"string","pattern":"^espn-draftkings:espn:(NBA|NFL|NHL|NCAAF|NCAAB|MLB|EPL|MLS):[0-9]{1,20}$"}},{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}}],"responses":{"200":{"description":"Verified source metadata with explicit identity and timestamp limitations.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","request_id"],"properties":{"data":{"type":"array","maxItems":2,"items":{"type":"object","required":["id","native_id","identity_provider","identity_scope","type","name","side","event_id","league"],"properties":{"id":{"type":"string"},"native_id":{"type":"string"},"identity_provider":{"const":"espn"},"identity_scope":{"type":"string"},"type":{"const":"team"},"name":{"type":"string"},"side":{"enum":["home","away"]},"event_id":{"type":"string"},"league":{"type":"string"}}}},"meta":{"type":"object","required":["source","metadata_provider","transport","source_url","observed_at","source_updated_at","receipt_time_is_source_freshness","canonical_cross_provider_identity","settlement_verified"],"properties":{"source":{"const":"draftkings"},"metadata_provider":{"const":"espn"},"transport":{"const":"live_espn_summary"},"source_url":{"type":"string","format":"uri"},"observed_at":{"type":"string","format":"date-time"},"source_updated_at":{"type":"null"},"receipt_time_is_source_freshness":{"const":false},"canonical_cross_provider_identity":{"const":false},"settlement_verified":{"const":false}}},"request_id":{"type":"string","format":"uuid"}}}}}},"400":{"description":"Request refused, identity missing, or metadata unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Request refused, identity missing, or metadata unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request refused, identity missing, or metadata unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Request refused, identity missing, or metadata unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request refused, identity missing, or metadata unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"500":{"description":"Request refused, identity missing, or metadata unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Request refused, identity missing, or metadata unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/participants/{id}":{"get":{"operationId":"getEventParticipant","summary":"get Event Participant","description":"Resolve an ESPN-native participant within a required verified event. Returns one row or 404 if the team is not in the event. No logos or cross-provider identity claims. Requires draftkings source grant; one successful read costs one shared credit. One bounded upstream fetch after stored-event verification. No pagination; unknown or repeated query parameters return 400.","security":[{"bearerKey":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^espn:(NBA|NFL|NHL|NCAAF|NCAAB|MLB|EPL|MLS):team:[0-9]{1,20}$"}},{"name":"event_id","in":"query","required":true,"schema":{"type":"string","pattern":"^espn-draftkings:espn:(NBA|NFL|NHL|NCAAF|NCAAB|MLB|EPL|MLS):[0-9]{1,20}$"}},{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}}],"responses":{"200":{"description":"Verified source metadata with explicit identity and timestamp limitations.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","request_id"],"properties":{"data":{"type":"array","maxItems":1,"items":{"type":"object","required":["id","native_id","identity_provider","identity_scope","type","name","side","event_id","league"],"properties":{"id":{"type":"string"},"native_id":{"type":"string"},"identity_provider":{"const":"espn"},"identity_scope":{"type":"string"},"type":{"const":"team"},"name":{"type":"string"},"side":{"enum":["home","away"]},"event_id":{"type":"string"},"league":{"type":"string"}}}},"meta":{"type":"object","required":["source","metadata_provider","transport","source_url","observed_at","source_updated_at","receipt_time_is_source_freshness","canonical_cross_provider_identity","settlement_verified"],"properties":{"source":{"const":"draftkings"},"metadata_provider":{"const":"espn"},"transport":{"const":"live_espn_summary"},"source_url":{"type":"string","format":"uri"},"observed_at":{"type":"string","format":"date-time"},"source_updated_at":{"type":"null"},"receipt_time_is_source_freshness":{"const":false},"canonical_cross_provider_identity":{"const":false},"settlement_verified":{"const":false}}},"request_id":{"type":"string","format":"uuid"}}}}}},"400":{"description":"Request refused, identity missing, or metadata unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Request refused, identity missing, or metadata unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request refused, identity missing, or metadata unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Request refused, identity missing, or metadata unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request refused, identity missing, or metadata unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"500":{"description":"Request refused, identity missing, or metadata unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Request refused, identity missing, or metadata unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/leagues":{"get":{"operationId":"getLeagues","summary":"get Leagues","description":"Leagues present in retained DraftKings-via-ESPN events. Counts describe retained rows, not guaranteed current coverage.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}},{"name":"sport","in":"query","required":false,"schema":{"type":"string","enum":["basketball","american-football","ice-hockey","baseball","soccer"]}},{"name":"upcoming_only","in":"query","required":false,"schema":{"type":"string","enum":["true","false"]}}],"responses":{"200":{"description":"Bounded retained records with explicit coverage metadata.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","pagination","request_id"],"properties":{"request_id":{"type":"string","format":"uuid"},"data":{"type":"array","maxItems":200,"items":{"type":"object","required":["id","name","sport","event_count","upcoming_event_count"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"sport":{"type":"string"},"event_count":{"type":"integer"},"upcoming_event_count":{"type":"integer"}}}},"meta":{"type":"object","properties":{"source":{"const":"draftkings"},"transport":{"const":"stored_espn_draftkings"},"checked_at":{"type":"string","format":"date-time"},"snapshot_consistent":{"const":false},"independent_bookmakers":{"const":1},"cross_book_comparison":{"const":false},"normalization":{"type":"string"},"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"},"event_state":{"const":"unknown"},"finished_events_verified":{"const":false},"archive_complete":{"const":false}}},"pagination":{"type":"object","required":["limit","offset","has_more","next_offset"],"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}}}}}}},"400":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"More than 2,000 input offers; narrow event selection or market."},"429":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"500":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/historical/events":{"get":{"operationId":"getHistoricalEvents","summary":"get Historical Events","description":"Retained events whose scheduled starts fall in [from,to). Required UTC Z timestamps, at most 31 days per request, to no later than now. State is unknown: these are not verified finished events or a complete archive.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}},{"name":"league","in":"query","required":true,"schema":{"type":"string","enum":["NBA","NFL","NHL","NCAAB","NCAAF","MLB","EPL","MLS"]}},{"name":"from","in":"query","required":true,"schema":{"type":"string","format":"date-time"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"Bounded retained records with explicit coverage metadata.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","pagination","request_id"],"properties":{"request_id":{"type":"string","format":"uuid"},"data":{"type":"array","maxItems":200,"items":{"type":"object","required":["id","sport","home","away","starts_at","observed_at","age_seconds","stale"],"properties":{"id":{"type":"string"},"sport":{"type":"string"},"home":{"type":"string"},"away":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"observed_at":{"type":"string","format":"date-time"},"age_seconds":{"type":"integer","minimum":0},"stale":{"type":"boolean"}}}},"meta":{"type":"object","properties":{"source":{"const":"draftkings"},"transport":{"const":"stored_espn_draftkings"},"checked_at":{"type":"string","format":"date-time"},"snapshot_consistent":{"const":false},"independent_bookmakers":{"const":1},"cross_book_comparison":{"const":false},"normalization":{"type":"string"},"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"},"event_state":{"const":"unknown"},"finished_events_verified":{"const":false},"archive_complete":{"const":false}}},"pagination":{"type":"object","required":["limit","offset","has_more","next_offset"],"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}}}}}}},"400":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"More than 2,000 input offers; narrow event selection or market."},"429":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"500":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/historical/events/search":{"get":{"operationId":"searchHistoricalEvents","summary":"search Historical Events","description":"Literal case-insensitive team-name search over a bounded retained event window. Same historical constraints; completion is not verified.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}},{"name":"league","in":"query","required":true,"schema":{"type":"string","enum":["NBA","NFL","NHL","NCAAB","NCAAF","MLB","EPL","MLS"]}},{"name":"from","in":"query","required":true,"schema":{"type":"string","format":"date-time"}},{"name":"to","in":"query","required":true,"schema":{"type":"string","format":"date-time"}},{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":100}}],"responses":{"200":{"description":"Bounded retained records with explicit coverage metadata.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","pagination","request_id"],"properties":{"request_id":{"type":"string","format":"uuid"},"data":{"type":"array","maxItems":200,"items":{"type":"object","required":["id","sport","home","away","starts_at","observed_at","age_seconds","stale"],"properties":{"id":{"type":"string"},"sport":{"type":"string"},"home":{"type":"string"},"away":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"observed_at":{"type":"string","format":"date-time"},"age_seconds":{"type":"integer","minimum":0},"stale":{"type":"boolean"}}}},"meta":{"type":"object","properties":{"source":{"const":"draftkings"},"transport":{"const":"stored_espn_draftkings"},"checked_at":{"type":"string","format":"date-time"},"snapshot_consistent":{"const":false},"independent_bookmakers":{"const":1},"cross_book_comparison":{"const":false},"normalization":{"type":"string"},"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"},"event_state":{"const":"unknown"},"finished_events_verified":{"const":false},"archive_complete":{"const":false}}},"pagination":{"type":"object","required":["limit","offset","has_more","next_offset"],"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}}}}}}},"400":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"More than 2,000 input offers; narrow event selection or market."},"429":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"500":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/odds/summary":{"get":{"operationId":"getOddsSummary","summary":"get Odds Summary","description":"Matching market-line summaries from one independent bookmaker. Captures must be within 15 minutes. Best, average, median and worst currently reflect the same single quote. Multiplicative normalization is returned only for complete expected sides with captures within 60 seconds; it is not a verified win probability. Spread reference_line is home-oriented; total reference_line is the total.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}},{"name":"event_id","in":"query","required":true,"schema":{"type":"string","maxLength":180}},{"name":"market","in":"query","required":false,"schema":{"type":"string","enum":["moneyline","spread","total"]}}],"responses":{"200":{"description":"Bounded retained records with explicit coverage metadata.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","pagination","request_id"],"properties":{"request_id":{"type":"string","format":"uuid"},"data":{"type":"array","maxItems":200,"items":{"type":"object","required":["event_id","league","market","period","reference_line","line_orientation","expected_sides_present","capture_times_coherent","bookmaker_count","implied_probability_sum","outcomes"],"properties":{"event_id":{"type":"string"},"league":{"type":"string"},"market":{"type":"string"},"period":{"type":"string"},"reference_line":{"type":["number","null"]},"line_orientation":{"enum":["home","total",null]},"expected_sides_present":{"type":"boolean"},"capture_times_coherent":{"type":"boolean"},"bookmaker_count":{"const":1},"implied_probability_sum":{"type":["number","null"]},"outcomes":{"type":"array","items":{"type":"object","required":["side","line","best_decimal","average_decimal","median_decimal","worst_decimal","bookmaker_count","normalized_price_probability","quotes"],"properties":{"side":{"type":"string"},"line":{"type":["number","null"]},"best_decimal":{"type":"number"},"average_decimal":{"type":"number"},"median_decimal":{"type":"number"},"worst_decimal":{"type":"number"},"bookmaker_count":{"const":1},"normalized_price_probability":{"type":["number","null"]},"quotes":{"type":"array","items":{"type":"object","required":["offer_id","bookmaker","decimal","american","observed_at"],"properties":{"offer_id":{"type":"string"},"bookmaker":{"const":"draftkings"},"decimal":{"type":"number"},"american":{"type":"integer"},"observed_at":{"type":"string","format":"date-time"}}}}}}}}}},"meta":{"type":"object","properties":{"source":{"const":"draftkings"},"transport":{"const":"stored_espn_draftkings"},"checked_at":{"type":"string","format":"date-time"},"snapshot_consistent":{"const":false},"independent_bookmakers":{"const":1},"cross_book_comparison":{"const":false},"normalization":{"type":"string"},"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"},"event_state":{"const":"unknown"},"finished_events_verified":{"const":false},"archive_complete":{"const":false}}},"pagination":{"type":"object","required":["limit","offset","has_more","next_offset"],"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}}}}}}},"400":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"More than 2,000 input offers; narrow event selection or market."},"429":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"500":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/odds/summary/multi":{"get":{"operationId":"getMultipleOddsSummaries","summary":"get Multiple Odds Summaries","description":"Same single-book summary contract across up to 20 events. At most 2,000 input offers; narrow selection if 422. Missing events produce no synthetic rows.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}},{"name":"event_ids","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated 1–20 distinct source event IDs."}},{"name":"market","in":"query","required":false,"schema":{"type":"string","enum":["moneyline","spread","total"]}}],"responses":{"200":{"description":"Bounded retained records with explicit coverage metadata.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","pagination","request_id"],"properties":{"request_id":{"type":"string","format":"uuid"},"data":{"type":"array","maxItems":200,"items":{"type":"object","required":["event_id","league","market","period","reference_line","line_orientation","expected_sides_present","capture_times_coherent","bookmaker_count","implied_probability_sum","outcomes"],"properties":{"event_id":{"type":"string"},"league":{"type":"string"},"market":{"type":"string"},"period":{"type":"string"},"reference_line":{"type":["number","null"]},"line_orientation":{"enum":["home","total",null]},"expected_sides_present":{"type":"boolean"},"capture_times_coherent":{"type":"boolean"},"bookmaker_count":{"const":1},"implied_probability_sum":{"type":["number","null"]},"outcomes":{"type":"array","items":{"type":"object","required":["side","line","best_decimal","average_decimal","median_decimal","worst_decimal","bookmaker_count","normalized_price_probability","quotes"],"properties":{"side":{"type":"string"},"line":{"type":["number","null"]},"best_decimal":{"type":"number"},"average_decimal":{"type":"number"},"median_decimal":{"type":"number"},"worst_decimal":{"type":"number"},"bookmaker_count":{"const":1},"normalized_price_probability":{"type":["number","null"]},"quotes":{"type":"array","items":{"type":"object","required":["offer_id","bookmaker","decimal","american","observed_at"],"properties":{"offer_id":{"type":"string"},"bookmaker":{"const":"draftkings"},"decimal":{"type":"number"},"american":{"type":"integer"},"observed_at":{"type":"string","format":"date-time"}}}}}}}}}},"meta":{"type":"object","properties":{"source":{"const":"draftkings"},"transport":{"const":"stored_espn_draftkings"},"checked_at":{"type":"string","format":"date-time"},"snapshot_consistent":{"const":false},"independent_bookmakers":{"const":1},"cross_book_comparison":{"const":false},"normalization":{"type":"string"},"from":{"type":"string","format":"date-time"},"to":{"type":"string","format":"date-time"},"event_state":{"const":"unknown"},"finished_events_verified":{"const":false},"archive_complete":{"const":false}}},"pagination":{"type":"object","required":["limit","offset","has_more","next_offset"],"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}}}}}}},"400":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"More than 2,000 input offers; narrow event selection or market."},"429":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"500":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/events":{"get":{"operationId":"getSportsbookEvents","summary":"Read stored DraftKings events","description":"Stored DraftKings-via-ESPN data. Requires a key explicitly scoped to draftkings; offset pages are not a frozen snapshot.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}},{"name":"sport","in":"query","schema":{"type":"string","enum":["NFL","NBA","NHL","NCAAF","NCAAB","MLB","EPL","MLS"]}},{"name":"event_id","in":"query","schema":{"type":"string","maxLength":180}}],"responses":{"200":{"description":"A page of retained observations; possibly empty.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","pagination","request_id"],"properties":{"request_id":{"type":"string","format":"uuid"},"data":{"type":"array","maxItems":200,"items":{"type":"object","required":["id","sport","home","away","starts_at","observed_at","age_seconds","stale"],"properties":{"id":{"type":"string"},"sport":{"type":"string"},"home":{"type":"string"},"away":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"observed_at":{"type":"string","format":"date-time"},"age_seconds":{"type":"integer","minimum":0},"stale":{"type":"boolean"}}}},"meta":{"type":"object","properties":{"source":{"const":"draftkings"},"transport":{"const":"stored_espn_draftkings"},"checked_at":{"type":"string","format":"date-time"},"snapshot_consistent":{"const":false},"receipt_time_is_source_freshness":{"const":false},"history_window_days":{"type":["integer","null"]}}},"pagination":{"type":"object","required":["limit","offset","has_more","next_offset"],"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}}}}}}},"400":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"500":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/odds":{"get":{"operationId":"getSportsbookOdds","summary":"Read stored DraftKings odds","description":"Stored DraftKings-via-ESPN data. Requires a key explicitly scoped to draftkings; offset pages are not a frozen snapshot.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}},{"name":"sport","in":"query","schema":{"type":"string","enum":["NFL","NBA","NHL","NCAAF","NCAAB","MLB","EPL","MLS"]}},{"name":"event_id","in":"query","schema":{"type":"string","maxLength":180}},{"name":"market","in":"query","schema":{"type":"string","enum":["moneyline","spread","total"]}},{"name":"fresh_only","in":"query","schema":{"type":"string","enum":["true","false"],"default":"false"}}],"responses":{"200":{"description":"A page of retained observations; possibly empty.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","pagination","request_id"],"properties":{"request_id":{"type":"string","format":"uuid"},"data":{"type":"array","maxItems":200,"items":{"type":"object","required":["id","event_id","sport","market","period","side","home","away","starts_at","line","american","decimal","observed_at","source_updated_at","age_seconds","stale"],"properties":{"id":{"type":"string"},"event_id":{"type":"string"},"sport":{"type":"string"},"market":{"type":"string"},"period":{"type":"string"},"side":{"type":"string"},"home":{"type":"string"},"away":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"line":{"type":["number","null"]},"american":{"type":"integer"},"decimal":{"type":"number","exclusiveMinimum":1},"observed_at":{"type":"string","format":"date-time"},"source_updated_at":{"type":["string","null"],"format":"date-time"},"age_seconds":{"type":"integer","minimum":0},"stale":{"type":"boolean"}}}},"meta":{"type":"object","properties":{"source":{"const":"draftkings"},"transport":{"const":"stored_espn_draftkings"},"checked_at":{"type":"string","format":"date-time"},"snapshot_consistent":{"const":false},"receipt_time_is_source_freshness":{"const":false},"history_window_days":{"type":["integer","null"]}}},"pagination":{"type":"object","required":["limit","offset","has_more","next_offset"],"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}}}}}}},"400":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"500":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/history":{"get":{"operationId":"getSportsbookHistory","summary":"Read stored DraftKings history","description":"Supply event_id or offer_id. Every retained change since collection began, newest first. Missing observations are not reconstructed.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}},{"name":"sport","in":"query","schema":{"type":"string","enum":["NFL","NBA","NHL","NCAAF","NCAAB","MLB","EPL","MLS"]}},{"name":"event_id","in":"query","schema":{"type":"string","maxLength":180}},{"name":"offer_id","in":"query","schema":{"type":"string","maxLength":180}},{"name":"market","in":"query","schema":{"type":"string","enum":["moneyline","spread","total"]}}],"responses":{"200":{"description":"A page of retained observations; possibly empty.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","pagination","request_id"],"properties":{"request_id":{"type":"string","format":"uuid"},"data":{"type":"array","maxItems":200,"items":{"type":"object","required":["seq","offer_id","event_id","sport","market","period","side","line","american","decimal","observed_at","age_seconds","stale"],"properties":{"seq":{"type":"string"},"offer_id":{"type":"string"},"event_id":{"type":"string"},"sport":{"type":"string"},"market":{"type":"string"},"period":{"type":"string"},"side":{"type":"string"},"line":{"type":["number","null"]},"american":{"type":"integer"},"decimal":{"type":"number","exclusiveMinimum":1},"observed_at":{"type":"string","format":"date-time"},"age_seconds":{"type":"integer","minimum":0},"stale":{"type":"boolean"}}}},"meta":{"type":"object","properties":{"source":{"const":"draftkings"},"transport":{"const":"stored_espn_draftkings"},"checked_at":{"type":"string","format":"date-time"},"snapshot_consistent":{"const":false},"receipt_time_is_source_freshness":{"const":false},"history_window_days":{"type":["integer","null"]}}},"pagination":{"type":"object","required":["limit","offset","has_more","next_offset"],"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}}}}}}},"400":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"500":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/sports":{"get":{"operationId":"getSportsbookSports","summary":"Read stored DraftKings sports","description":"Stored DraftKings-via-ESPN data. Requires a key explicitly scoped to draftkings; offset pages are not a frozen snapshot.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}}],"responses":{"200":{"description":"A page of retained observations; possibly empty.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","pagination","request_id"],"properties":{"request_id":{"type":"string","format":"uuid"},"data":{"type":"array","maxItems":200,"items":{"type":"object","required":["id","name"],"properties":{"id":{"type":"string"},"name":{"type":"string"}}}},"meta":{"type":"object","properties":{"source":{"const":"draftkings"},"transport":{"const":"stored_espn_draftkings"},"checked_at":{"type":"string","format":"date-time"},"snapshot_consistent":{"const":false},"receipt_time_is_source_freshness":{"const":false},"history_window_days":{"type":["integer","null"]}}},"pagination":{"type":"object","required":["limit","offset","has_more","next_offset"],"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}}}}}}},"400":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"500":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/bookmakers":{"get":{"operationId":"getSportsbookBookmakers","summary":"Read stored DraftKings bookmakers","description":"Stored DraftKings-via-ESPN data. Requires a key explicitly scoped to draftkings; offset pages are not a frozen snapshot.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}}],"responses":{"200":{"description":"A page of retained observations; possibly empty.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","pagination","request_id"],"properties":{"request_id":{"type":"string","format":"uuid"},"data":{"type":"array","maxItems":200,"items":{"type":"object","required":["id","name"],"properties":{"id":{"const":"draftkings"},"name":{"type":"string"}}}},"meta":{"type":"object","properties":{"source":{"const":"draftkings"},"transport":{"const":"stored_espn_draftkings"},"checked_at":{"type":"string","format":"date-time"},"snapshot_consistent":{"const":false},"receipt_time_is_source_freshness":{"const":false},"history_window_days":{"type":["integer","null"]}}},"pagination":{"type":"object","required":["limit","offset","has_more","next_offset"],"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}}}}}}},"400":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"500":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/market-types":{"get":{"operationId":"getSportsbookMarketTypes","summary":"Read stored DraftKings market-types","description":"Stored DraftKings-via-ESPN data. Requires a key explicitly scoped to draftkings; offset pages are not a frozen snapshot.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}}],"responses":{"200":{"description":"A page of retained observations; possibly empty.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","pagination","request_id"],"properties":{"request_id":{"type":"string","format":"uuid"},"data":{"type":"array","maxItems":200,"items":{"type":"object","required":["market","period"],"properties":{"market":{"type":"string"},"period":{"type":"string"}}}},"meta":{"type":"object","properties":{"source":{"const":"draftkings"},"transport":{"const":"stored_espn_draftkings"},"checked_at":{"type":"string","format":"date-time"},"snapshot_consistent":{"const":false},"receipt_time_is_source_freshness":{"const":false},"history_window_days":{"type":["integer","null"]}}},"pagination":{"type":"object","required":["limit","offset","has_more","next_offset"],"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}}}}}}},"400":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"500":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/events/search":{"get":{"operationId":"searchEvents","summary":"Search retained event team names","description":"Case-insensitive literal substring search over home and away names. One retained source; results may include past events.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}},{"name":"sport","in":"query","schema":{"type":"string","enum":["NFL","NBA","NHL","NCAAF","NCAAB","MLB","EPL","MLS"]}},{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":100}}],"responses":{"200":{"description":"Bounded source records; possibly empty.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","pagination","request_id"],"properties":{"request_id":{"type":"string","format":"uuid"},"data":{"type":"array","maxItems":200,"items":{"type":"object","required":["id","sport","home","away","starts_at","observed_at","age_seconds","stale"],"properties":{"id":{"type":"string"},"sport":{"type":"string"},"home":{"type":"string"},"away":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"observed_at":{"type":"string","format":"date-time"},"age_seconds":{"type":"integer","minimum":0},"stale":{"type":"boolean"}}}},"meta":{"type":"object","properties":{"source":{"const":"draftkings"},"transport":{"const":"stored_espn_draftkings"},"checked_at":{"type":"string","format":"date-time"},"snapshot_consistent":{"const":false},"receipt_time_is_source_freshness":{"const":false},"history_window_days":{"type":["integer","null"]}}},"pagination":{"type":"object","required":["limit","offset","has_more","next_offset"],"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}}}}}}},"400":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"500":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/events/{id}":{"get":{"operationId":"getEvent","summary":"Get one retained event by source ID","description":"Returns a one-row data array or 404. The ID is source-specific, not a canonical cross-book identity.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}},{"name":"id","in":"path","required":true,"schema":{"type":"string","maxLength":180}}],"responses":{"200":{"description":"Bounded source records; possibly empty.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","pagination","request_id"],"properties":{"request_id":{"type":"string","format":"uuid"},"data":{"type":"array","maxItems":200,"items":{"type":"object","required":["id","sport","home","away","starts_at","observed_at","age_seconds","stale"],"properties":{"id":{"type":"string"},"sport":{"type":"string"},"home":{"type":"string"},"away":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"observed_at":{"type":"string","format":"date-time"},"age_seconds":{"type":"integer","minimum":0},"stale":{"type":"boolean"}}}},"meta":{"type":"object","properties":{"source":{"const":"draftkings"},"transport":{"const":"stored_espn_draftkings"},"checked_at":{"type":"string","format":"date-time"},"snapshot_consistent":{"const":false},"receipt_time_is_source_freshness":{"const":false},"history_window_days":{"type":["integer","null"]}}},"pagination":{"type":"object","required":["limit","offset","has_more","next_offset"],"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}}}}}}},"400":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No retained event matches the source ID."},"429":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"500":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/odds/multi":{"get":{"operationId":"getMultipleEventOdds","summary":"Read stored odds for up to 20 event IDs","description":"One bounded combined page across the requested IDs. Missing events are not invented. Offset pages are not a frozen snapshot.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}},{"name":"sport","in":"query","schema":{"type":"string","enum":["NFL","NBA","NHL","NCAAF","NCAAB","MLB","EPL","MLS"]}},{"name":"market","in":"query","schema":{"type":"string","enum":["moneyline","spread","total"]}},{"name":"fresh_only","in":"query","schema":{"type":"string","enum":["true","false"],"default":"false"}},{"name":"event_ids","in":"query","required":true,"schema":{"type":"string","description":"Comma-separated list of 1–20 distinct source event IDs."}}],"responses":{"200":{"description":"Bounded source records; possibly empty.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","pagination","request_id"],"properties":{"request_id":{"type":"string","format":"uuid"},"data":{"type":"array","maxItems":200,"items":{"type":"object","required":["id","event_id","sport","market","period","side","home","away","starts_at","line","american","decimal","observed_at","source_updated_at","age_seconds","stale"],"properties":{"id":{"type":"string"},"event_id":{"type":"string"},"sport":{"type":"string"},"market":{"type":"string"},"period":{"type":"string"},"side":{"type":"string"},"home":{"type":"string"},"away":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"line":{"type":["number","null"]},"american":{"type":"integer"},"decimal":{"type":"number","exclusiveMinimum":1},"observed_at":{"type":"string","format":"date-time"},"source_updated_at":{"type":["string","null"],"format":"date-time"},"age_seconds":{"type":"integer","minimum":0},"stale":{"type":"boolean"}}}},"meta":{"type":"object","properties":{"source":{"const":"draftkings"},"transport":{"const":"stored_espn_draftkings"},"checked_at":{"type":"string","format":"date-time"},"snapshot_consistent":{"const":false},"receipt_time_is_source_freshness":{"const":false},"history_window_days":{"type":["integer","null"]}}},"pagination":{"type":"object","required":["limit","offset","has_more","next_offset"],"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}}}}}}},"400":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"500":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/odds/updated":{"get":{"operationId":"getChangedOdds","summary":"Read current offers with retained changes since a timestamp","description":"Requires an ISO timestamp within the last seven days. Matches retained history changes strictly after since, then returns the current stored offer. This is not a replay stream or a guarantee that every past change was captured.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}},{"name":"sport","in":"query","schema":{"type":"string","enum":["NFL","NBA","NHL","NCAAF","NCAAB","MLB","EPL","MLS"]}},{"name":"market","in":"query","schema":{"type":"string","enum":["moneyline","spread","total"]}},{"name":"fresh_only","in":"query","schema":{"type":"string","enum":["true","false"],"default":"false"}},{"name":"since","in":"query","required":true,"schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"Bounded source records; possibly empty.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","pagination","request_id"],"properties":{"request_id":{"type":"string","format":"uuid"},"data":{"type":"array","maxItems":200,"items":{"type":"object","required":["id","event_id","sport","market","period","side","home","away","starts_at","line","american","decimal","observed_at","source_updated_at","age_seconds","stale","changed_at"],"properties":{"id":{"type":"string"},"event_id":{"type":"string"},"sport":{"type":"string"},"market":{"type":"string"},"period":{"type":"string"},"side":{"type":"string"},"home":{"type":"string"},"away":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"line":{"type":["number","null"]},"american":{"type":"integer"},"decimal":{"type":"number","exclusiveMinimum":1},"observed_at":{"type":"string","format":"date-time"},"source_updated_at":{"type":["string","null"],"format":"date-time"},"age_seconds":{"type":"integer","minimum":0},"stale":{"type":"boolean"},"changed_at":{"type":"string","format":"date-time"}}}},"meta":{"type":"object","properties":{"source":{"const":"draftkings"},"transport":{"const":"stored_espn_draftkings"},"checked_at":{"type":"string","format":"date-time"},"snapshot_consistent":{"const":false},"receipt_time_is_source_freshness":{"const":false},"history_window_days":{"type":["integer","null"]}}},"pagination":{"type":"object","required":["limit","offset","has_more","next_offset"],"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}}}}}}},"400":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"500":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/dropping-odds":{"get":{"operationId":"getDroppingOdds","summary":"Read same-line decimal-price decreases","description":"Compares the latest two retained changes within 24 hours for identical event, market, period, side and line. Requires a fresh capture (15 minutes), an upcoming event and a current price matching the latest change. Percentage decrease is (previous_decimal-current_decimal)/previous_decimal*100. This is not a value or arbitrage signal.","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"const":"draftkings","default":"draftkings"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0}},{"name":"sport","in":"query","schema":{"type":"string","enum":["NFL","NBA","NHL","NCAAF","NCAAB","MLB","EPL","MLS"]}},{"name":"market","in":"query","schema":{"type":"string","enum":["moneyline","spread","total"]}},{"name":"min_drop_pct","in":"query","required":false,"schema":{"type":"number","minimum":0.1,"exclusiveMaximum":100,"default":1}}],"responses":{"200":{"description":"Bounded source records; possibly empty.","content":{"application/json":{"schema":{"type":"object","required":["data","meta","pagination","request_id"],"properties":{"request_id":{"type":"string","format":"uuid"},"data":{"type":"array","maxItems":200,"items":{"type":"object","required":["id","event_id","sport","market","period","side","home","away","starts_at","line","american","decimal","observed_at","source_updated_at","age_seconds","stale","changed_at","previous_observed_at","previous_decimal","drop_pct"],"properties":{"id":{"type":"string"},"event_id":{"type":"string"},"sport":{"type":"string"},"market":{"type":"string"},"period":{"type":"string"},"side":{"type":"string"},"home":{"type":"string"},"away":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"line":{"type":["number","null"]},"american":{"type":"integer"},"decimal":{"type":"number","exclusiveMinimum":1},"observed_at":{"type":"string","format":"date-time"},"source_updated_at":{"type":["string","null"],"format":"date-time"},"age_seconds":{"type":"integer","minimum":0},"stale":{"type":"boolean"},"changed_at":{"type":"string","format":"date-time"},"previous_observed_at":{"type":"string","format":"date-time"},"previous_decimal":{"type":"number","exclusiveMinimum":1},"drop_pct":{"type":"number"}}}},"meta":{"type":"object","properties":{"source":{"const":"draftkings"},"transport":{"const":"stored_espn_draftkings"},"checked_at":{"type":"string","format":"date-time"},"snapshot_consistent":{"const":false},"receipt_time_is_source_freshness":{"const":false},"history_window_days":{"type":["integer","null"]}}},"pagination":{"type":"object","required":["limit","offset","has_more","next_offset"],"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"has_more":{"type":"boolean"},"next_offset":{"type":["integer","null"]}}}}}}}},"400":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"500":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Request refused or source unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/agent/signup":{"post":{"operationId":"agentSignup","summary":"Create a free GetOdds key without a browser (shown once)","security":[],"description":"Free tier only: 1,000 requests per UTC day and 60 per minute, every source granted, DraftKings, FanDuel and BetRivers selected. One key per email (+tags and Gmail dots are ignored when checking). Disposable, reserved and MX-less domains are refused. Capped per network address and globally. The key is returned once in the response; no email is sent.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["email"],"properties":{"email":{"type":"string","format":"email","maxLength":254},"agent_name":{"type":"string","maxLength":80},"use_case":{"type":"string","maxLength":500}}}}}},"responses":{"201":{"description":"Key issued. Store api_key now; it is not shown again.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentSignup"}}}},"400":{"description":"Invalid body, email, or email domain","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"409":{"description":"Email already has an account (EMAIL_ALREADY_REGISTERED)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"413":{"description":"Body over 4 KiB","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"415":{"description":"Body is not JSON","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited; see Retry-After.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retry."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Signup paused or at capacity (SIGNUP_PAUSED, SIGNUP_BUSY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"operationId":"agentSignupHelp","summary":"Describe the agent signup request","security":[],"responses":{"200":{"description":"Plain description of the POST body and limits.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/sandbox":{"get":{"operationId":"sandboxIndex","summary":"Keyless sandbox: endpoints and limits","security":[],"responses":{"200":{"description":"Sandbox index, always sandbox: true.","content":{"application/json":{"schema":{"type":"object","required":["sandbox"],"properties":{"sandbox":{"const":true}}}}}}}}},"/api/v1/sandbox/sports":{"get":{"operationId":"sandboxSports","summary":"Keyless sandbox: sports with a board","security":[],"responses":{"200":{"description":"Sport slugs accepted by /api/v1/sandbox/odds.","content":{"application/json":{"schema":{"type":"object","required":["sandbox","data"],"properties":{"sandbox":{"const":true},"data":{"type":"array","items":{"type":"object","properties":{"sport":{"type":"string"},"name":{"type":"string"},"codes":{"type":"array","items":{"type":"string"}},"example":{"type":"string"}}}}}}}}}}}},"/api/v1/sandbox/odds":{"get":{"operationId":"sandboxOdds","summary":"Keyless sandbox: cached DraftKings game lines for one sport","security":[],"description":"Real stored DraftKings (via ESPN) moneyline, spread and total rows from a cache up to 300 seconds old, at most 50 rows. 10 requests a minute and 100 a day per network address. For current prices use a free key.","parameters":[{"name":"sport","in":"query","required":true,"schema":{"type":"string","enum":["nfl","nba","nhl","ncaaf","college-football","soccer","epl","mls"]}}],"responses":{"200":{"description":"Labelled sandbox rows (sandbox: true, delayed_up_to_seconds: 300).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SandboxOdds"}}}},"400":{"description":"Unknown sport or extra parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limited; see Retry-After.","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retry."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Board unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v4/sports":{"get":{"operationId":"oddsApiV4Sports","summary":"The Odds API v4 shape: sports GetOdds maps (0 credits)","security":[{"bearerKey":[]},{"oddsApiKey":[]}],"description":"Same request and response shape as The Odds API GET /v4/sports. Lists sports with upcoming DraftKings or FanDuel games; all=true lists every mapped sport.","parameters":[{"name":"apiKey","in":"query","required":false,"schema":{"type":"string"},"description":"The Odds API style key parameter. The Authorization: Bearer header also works and keeps the key out of logs."},{"name":"all","in":"query","schema":{"type":"string","enum":["true","false"]}}],"responses":{"200":{"description":"Sports.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OddsApiV4Sport"}}}}},"401":{"description":"Missing or invalid key (MISSING_KEY, INVALID_KEY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}}},"404":{"description":"Unknown or unmapped sport (UNKNOWN_SPORT) or event (EVENT_NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}}},"422":{"description":"Unsupported parameter, region, market, bookmaker or format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}}},"429":{"description":"EXCEEDED_FREQ_LIMIT or OUT_OF_USAGE_CREDITS","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"503":{"description":"Stored DraftKings and FanDuel events both unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}}}}}},"/v4/sports/{sport}/odds":{"get":{"operationId":"oddsApiV4Odds","summary":"The Odds API v4 shape: game odds at every GetOdds book for one sport (1 credit)","security":[{"bearerKey":[]},{"oddsApiKey":[]}],"description":"Same request and response shape as The Odds API GET /v4/sports/{sport}/odds: events[].bookmakers[] with key, title, last_update and markets[] (h2h, spreads, totals) of outcomes (name, price, point). Bookmakers: draftkings, fanduel, betrivers (region us), novig (us_ex, the ask price), pinnacle (eu). Pregame prices only; a started event carries no bookmakers and is left out. Each book keeps its own main line; none is filled in from another. Event ids are the stored DraftKings (ESPN) ids, or fanduel:<id> for games only FanDuel lists. One request costs one GetOdds credit however many markets and regions; The Odds API charges per market per region. Player props are on /v4/sports/{sport}/events/{eventId}/odds, as on The Odds API.","parameters":[{"name":"sport","in":"path","required":true,"schema":{"type":"string","enum":["americanfootball_nfl","americanfootball_ncaaf","basketball_nba","basketball_ncaab","icehockey_nhl","baseball_mlb","soccer_epl","soccer_usa_mls","soccer_uefa_champs_league","soccer_germany_bundesliga","soccer_spain_la_liga","soccer_italy_serie_a","soccer_france_ligue_one"]}},{"name":"apiKey","in":"query","required":false,"schema":{"type":"string"},"description":"The Odds API style key parameter. The Authorization: Bearer header also works and keeps the key out of logs."},{"name":"dateFormat","in":"query","schema":{"type":"string","enum":["iso","unix"],"default":"iso"}},{"name":"eventIds","in":"query","schema":{"type":"string"},"description":"Comma-separated GetOdds event ids (up to 50)."},{"name":"commenceTimeFrom","in":"query","schema":{"type":"string","format":"date-time"},"description":"ISO 8601 UTC, e.g. 2026-11-15T18:00:00Z. Clamped to now minus 6 hours."},{"name":"commenceTimeTo","in":"query","schema":{"type":"string","format":"date-time"},"description":"ISO 8601 UTC. Clamped to now plus 21 days."},{"name":"regions","in":"query","schema":{"type":"string"},"description":"Comma-separated The Odds API regions: us (draftkings, fanduel, betrivers), us_ex (novig), eu (pinnacle), us_dfs (underdog, player props on the per-event route). us2, uk, au, fr and se are accepted but GetOdds has no book there. Required unless bookmakers is set."},{"name":"bookmakers","in":"query","schema":{"type":"string"},"description":"Comma-separated bookmaker keys; overrides regions. Served: draftkings, fanduel, betrivers, pinnacle, novig (and underdog on the per-event route). Others are dropped and listed in x-getodds-unsupported-bookmakers."},{"name":"oddsFormat","in":"query","schema":{"type":"string","enum":["decimal","american"],"default":"decimal"}},{"name":"includeLinks","in":"query","schema":{"type":"string"},"description":"Accepted and ignored."},{"name":"includeSids","in":"query","schema":{"type":"string"},"description":"Accepted and ignored."},{"name":"includeBetLimits","in":"query","schema":{"type":"string"},"description":"Accepted and ignored."},{"name":"includeMultipliers","in":"query","schema":{"type":"string"},"description":"Accepted and ignored."},{"name":"markets","in":"query","schema":{"type":"string","default":"h2h"},"description":"Comma-separated: h2h, spreads, totals."}],"responses":{"200":{"description":"Events with each requested book's markets.","headers":{"x-requests-last":{"schema":{"type":"integer"},"description":"GetOdds credits used by this request (1 for odds and scores, 0 for sports and events)."},"x-requests-used":{"schema":{"type":"integer"},"description":"Requests used today (Free) or credits used this billing period (paid plans), counting this one. Absent on marketplace-proxied calls."},"x-requests-remaining":{"schema":{"type":"integer"},"description":"Requests left today (Free) or credits left this billing period (paid plans)."},"x-getodds-quota-unit":{"schema":{"type":"string","enum":["requests_today","credits_this_period"]}},"x-getodds-unsupported-bookmakers":{"schema":{"type":"string"},"description":"Requested bookmaker keys GetOdds does not carry (dropped)."},"x-getodds-unsupported-markets":{"schema":{"type":"string"},"description":"Requested The Odds API market keys GetOdds does not carry for this sport (dropped)."},"x-getodds-unavailable-bookmakers":{"schema":{"type":"string"},"description":"Carried bookmakers whose read failed on this request; the others are still returned."},"x-request-id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OddsApiV4Event"}}}}},"401":{"description":"Missing or invalid key (MISSING_KEY, INVALID_KEY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}}},"404":{"description":"Unknown or unmapped sport (UNKNOWN_SPORT) or event (EVENT_NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}}},"422":{"description":"Unsupported parameter, region, market, bookmaker or format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}}},"429":{"description":"EXCEEDED_FREQ_LIMIT or OUT_OF_USAGE_CREDITS","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"503":{"description":"Stored DraftKings and FanDuel events both unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}}}}}},"/v4/sports/{sport}/events/{eventId}/odds":{"get":{"operationId":"oddsApiV4EventOdds","summary":"The Odds API v4 shape: one event, game lines and player props at every book (1 credit)","security":[{"bearerKey":[]},{"oddsApiKey":[]}],"description":"Same shape as The Odds API GET /v4/sports/{sport}/events/{eventId}/odds: one event object. markets takes h2h, spreads, totals and, for NBA, NCAAB, NFL, NCAAF and NHL, The Odds API player prop keys (player_points, player_rebounds, player_assists, player_threes, player_points_rebounds_assists, player_pass_yds, player_rush_yds, player_reception_yds, player_receptions, player_shots_on_goal, player_total_saves and more). Prop outcomes are {name: Over|Under, description: player, price, point}. Prop books: fanduel, draftkings, betrivers, pinnacle, novig and underdog (us_dfs, only where Underdog posts a price); PrizePicks and Pick6 lines carry no price and are on /api/v1/props. Known The Odds API markets GetOdds does not carry (player_anytime_td, alternates) are dropped and listed in x-getodds-unsupported-markets.","parameters":[{"name":"sport","in":"path","required":true,"schema":{"type":"string","enum":["americanfootball_nfl","americanfootball_ncaaf","basketball_nba","basketball_ncaab","icehockey_nhl","baseball_mlb","soccer_epl","soccer_usa_mls","soccer_uefa_champs_league","soccer_germany_bundesliga","soccer_spain_la_liga","soccer_italy_serie_a","soccer_france_ligue_one"]}},{"name":"eventId","in":"path","required":true,"schema":{"type":"string"},"description":"Id from /v4/sports/{sport}/events or /odds."},{"name":"apiKey","in":"query","required":false,"schema":{"type":"string"},"description":"The Odds API style key parameter. The Authorization: Bearer header also works and keeps the key out of logs."},{"name":"dateFormat","in":"query","schema":{"type":"string","enum":["iso","unix"],"default":"iso"}},{"name":"regions","in":"query","schema":{"type":"string"},"description":"Comma-separated The Odds API regions: us (draftkings, fanduel, betrivers), us_ex (novig), eu (pinnacle), us_dfs (underdog, player props on the per-event route). us2, uk, au, fr and se are accepted but GetOdds has no book there. Required unless bookmakers is set."},{"name":"bookmakers","in":"query","schema":{"type":"string"},"description":"Comma-separated bookmaker keys; overrides regions. Served: draftkings, fanduel, betrivers, pinnacle, novig (and underdog on the per-event route). Others are dropped and listed in x-getodds-unsupported-bookmakers."},{"name":"oddsFormat","in":"query","schema":{"type":"string","enum":["decimal","american"],"default":"decimal"}},{"name":"includeLinks","in":"query","schema":{"type":"string"},"description":"Accepted and ignored."},{"name":"includeSids","in":"query","schema":{"type":"string"},"description":"Accepted and ignored."},{"name":"includeBetLimits","in":"query","schema":{"type":"string"},"description":"Accepted and ignored."},{"name":"includeMultipliers","in":"query","schema":{"type":"string"},"description":"Accepted and ignored."},{"name":"markets","in":"query","schema":{"type":"string","default":"h2h"},"description":"Comma-separated game and player prop market keys."}],"responses":{"200":{"description":"The event with each requested book's markets.","headers":{"x-requests-last":{"schema":{"type":"integer"},"description":"GetOdds credits used by this request (1 for odds and scores, 0 for sports and events)."},"x-requests-used":{"schema":{"type":"integer"},"description":"Requests used today (Free) or credits used this billing period (paid plans), counting this one. Absent on marketplace-proxied calls."},"x-requests-remaining":{"schema":{"type":"integer"},"description":"Requests left today (Free) or credits left this billing period (paid plans)."},"x-getodds-quota-unit":{"schema":{"type":"string","enum":["requests_today","credits_this_period"]}},"x-getodds-unsupported-bookmakers":{"schema":{"type":"string"},"description":"Requested bookmaker keys GetOdds does not carry (dropped)."},"x-getodds-unsupported-markets":{"schema":{"type":"string"},"description":"Requested The Odds API market keys GetOdds does not carry for this sport (dropped)."},"x-getodds-unavailable-bookmakers":{"schema":{"type":"string"},"description":"Carried bookmakers whose read failed on this request; the others are still returned."},"x-request-id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Event"}}}},"401":{"description":"Missing or invalid key (MISSING_KEY, INVALID_KEY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}}},"404":{"description":"Unknown or unmapped sport (UNKNOWN_SPORT) or event (EVENT_NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}}},"422":{"description":"Unsupported parameter, region, market, bookmaker or format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}}},"429":{"description":"EXCEEDED_FREQ_LIMIT or OUT_OF_USAGE_CREDITS","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"503":{"description":"Stored DraftKings and FanDuel events both unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}}}}}},"/v4/sports/{sport}/scores":{"get":{"operationId":"oddsApiV4Scores","summary":"The Odds API v4 shape: upcoming, live and recent scores (1 credit)","security":[{"bearerKey":[]},{"oddsApiKey":[]}],"description":"Same shape as The Odds API GET /v4/sports/{sport}/scores, from the ESPN scoreboard: today and tomorrow (US Eastern) for upcoming and live games; daysFrom=1..3 adds games completed in that many days. scores is null before a game starts. Event ids match /v4/sports/{sport}/events for leagues GetOdds stores DraftKings lines for; other leagues use espn:<sport_key>:<id>. Scores are ESPN values, not sportsbook settlement.","parameters":[{"name":"sport","in":"path","required":true,"schema":{"type":"string","enum":["americanfootball_nfl","americanfootball_ncaaf","basketball_nba","basketball_ncaab","icehockey_nhl","baseball_mlb","soccer_epl","soccer_usa_mls","soccer_uefa_champs_league","soccer_germany_bundesliga","soccer_spain_la_liga","soccer_italy_serie_a","soccer_france_ligue_one"]}},{"name":"apiKey","in":"query","required":false,"schema":{"type":"string"},"description":"The Odds API style key parameter. The Authorization: Bearer header also works and keeps the key out of logs."},{"name":"dateFormat","in":"query","schema":{"type":"string","enum":["iso","unix"],"default":"iso"}},{"name":"eventIds","in":"query","schema":{"type":"string"},"description":"Comma-separated GetOdds event ids (up to 50)."},{"name":"daysFrom","in":"query","schema":{"type":"integer","minimum":1,"maximum":3}}],"responses":{"200":{"description":"Events with scores.","headers":{"x-requests-last":{"schema":{"type":"integer"},"description":"GetOdds credits used by this request (1 for odds and scores, 0 for sports and events)."},"x-requests-used":{"schema":{"type":"integer"},"description":"Requests used today (Free) or credits used this billing period (paid plans), counting this one. Absent on marketplace-proxied calls."},"x-requests-remaining":{"schema":{"type":"integer"},"description":"Requests left today (Free) or credits left this billing period (paid plans)."},"x-getodds-quota-unit":{"schema":{"type":"string","enum":["requests_today","credits_this_period"]}},"x-getodds-unsupported-bookmakers":{"schema":{"type":"string"},"description":"Requested bookmaker keys GetOdds does not carry (dropped)."},"x-getodds-unsupported-markets":{"schema":{"type":"string"},"description":"Requested The Odds API market keys GetOdds does not carry for this sport (dropped)."},"x-getodds-unavailable-bookmakers":{"schema":{"type":"string"},"description":"Carried bookmakers whose read failed on this request; the others are still returned."},"x-request-id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OddsApiV4Score"}}}}},"401":{"description":"Missing or invalid key (MISSING_KEY, INVALID_KEY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}}},"404":{"description":"Unknown or unmapped sport (UNKNOWN_SPORT) or event (EVENT_NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}}},"422":{"description":"Unsupported parameter, region, market, bookmaker or format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}}},"429":{"description":"EXCEEDED_FREQ_LIMIT or OUT_OF_USAGE_CREDITS","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"503":{"description":"Stored DraftKings and FanDuel events both unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}}}}}},"/v4/sports/{sport}/events":{"get":{"operationId":"oddsApiV4Events","summary":"The Odds API v4 shape: upcoming events without odds (0 credits)","security":[{"bearerKey":[]},{"oddsApiKey":[]}],"parameters":[{"name":"sport","in":"path","required":true,"schema":{"type":"string","enum":["americanfootball_nfl","americanfootball_ncaaf","basketball_nba","basketball_ncaab","icehockey_nhl","baseball_mlb","soccer_epl","soccer_usa_mls","soccer_uefa_champs_league","soccer_germany_bundesliga","soccer_spain_la_liga","soccer_italy_serie_a","soccer_france_ligue_one"]}},{"name":"apiKey","in":"query","required":false,"schema":{"type":"string"},"description":"The Odds API style key parameter. The Authorization: Bearer header also works and keeps the key out of logs."},{"name":"dateFormat","in":"query","schema":{"type":"string","enum":["iso","unix"],"default":"iso"}},{"name":"eventIds","in":"query","schema":{"type":"string"},"description":"Comma-separated GetOdds event ids (up to 50)."},{"name":"commenceTimeFrom","in":"query","schema":{"type":"string","format":"date-time"},"description":"ISO 8601 UTC, e.g. 2026-11-15T18:00:00Z. Clamped to now minus 6 hours."},{"name":"commenceTimeTo","in":"query","schema":{"type":"string","format":"date-time"},"description":"ISO 8601 UTC. Clamped to now plus 21 days."}],"responses":{"200":{"description":"Events.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/OddsApiV4Event"}}}}},"401":{"description":"Missing or invalid key (MISSING_KEY, INVALID_KEY)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}}},"404":{"description":"Unknown or unmapped sport (UNKNOWN_SPORT) or event (EVENT_NOT_FOUND)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}}},"422":{"description":"Unsupported parameter, region, market, bookmaker or format","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}}},"429":{"description":"EXCEEDED_FREQ_LIMIT or OUT_OF_USAGE_CREDITS","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}},"headers":{"Retry-After":{"schema":{"type":"integer"}}}},"503":{"description":"Stored DraftKings and FanDuel events both unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OddsApiV4Error"}}}}}}},"/api/v1/markets":{"get":{"operationId":"getMarkets","summary":"Read an incomplete source-specific player threshold sample","security":[{"bearerKey":[]}],"parameters":[{"name":"source","in":"query","schema":{"type":"string","enum":["prizepicks","underdog","draftkings","fanduel"],"default":"prizepicks"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}}],"responses":{"200":{"description":"Possibly empty sample. Receipt time does not prove quote freshness.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketResponse"}}}},"400":{"description":"Invalid source or limit","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Invalid or revoked key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Source excluded from key grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Customer request allowance reached","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds before retry."}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal or accounting failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"502":{"description":"Invalid source response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Source unavailable or rate limited","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"504":{"description":"Source timeout","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"bearerKey":{"type":"http","scheme":"bearer","description":"Issue a GetOdds key in /dashboard or with POST /api/v1/agent/signup. Never put it in a URL."},"oddsApiKey":{"type":"apiKey","in":"query","name":"apiKey","description":"Accepted only on the /v4 compatibility paths, for clients written against The Odds API. Prefer the bearer header."}},"schemas":{"AgentSignup":{"type":"object","required":["api_key","key_prefix","shown_once","plan","limits","sources"],"properties":{"api_key":{"type":"string","pattern":"^go_live_[A-Za-z0-9_-]{43}$"},"key_prefix":{"type":"string"},"key_id":{"type":"string","format":"uuid"},"shown_once":{"const":true},"email":{"type":"string"},"plan":{"const":"free"},"limits":{"type":"object","properties":{"requests_per_utc_day":{"type":"integer"},"requests_per_minute":{"type":"integer"},"card_required":{"const":false}}},"sources":{"type":"array","items":{"type":"string"}},"bookmakers_selected":{"type":"array","items":{"type":"string"}},"first_request":{"type":"string"},"odds_api_v4_compatible":{"type":"string"},"mcp":{"type":"string"},"openapi":{"type":"string"},"docs":{"type":"string"},"upgrade":{"type":"string"},"agent_next_step":{"type":"string"}}},"SandboxOdds":{"type":"object","required":["sandbox","delayed_up_to_seconds","sport","state","data"],"properties":{"sandbox":{"const":true},"delayed_up_to_seconds":{"type":"integer"},"source":{"type":"string"},"sport":{"type":"string"},"state":{"type":"string","enum":["available","empty"]},"cached_at":{"type":"string","format":"date-time"},"has_more":{"type":"boolean"},"data":{"type":"array","maxItems":50,"items":{"type":"object","properties":{"event_id":{"type":"string"},"sport":{"type":"string"},"home":{"type":"string"},"away":{"type":"string"},"starts_at":{"type":"string","format":"date-time"},"market":{"type":"string","enum":["moneyline","spread","total"]},"period":{"type":"string"},"side":{"type":"string"},"line":{"type":["number","null"]},"american":{"type":"integer"},"decimal":{"type":"number"},"observed_at":{"type":"string","format":"date-time"}}}}}},"OddsApiV4Sport":{"type":"object","required":["key","group","title","description","active","has_outrights"],"properties":{"key":{"type":"string"},"group":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"active":{"type":"boolean"},"has_outrights":{"type":"boolean"}}},"OddsApiV4Event":{"type":"object","required":["id","sport_key","sport_title","commence_time","home_team","away_team"],"properties":{"id":{"type":"string"},"sport_key":{"type":"string"},"sport_title":{"type":"string"},"commence_time":{"type":["string","integer"]},"home_team":{"type":"string"},"away_team":{"type":"string"},"bookmakers":{"type":"array","items":{"type":"object","required":["key","title","last_update","markets"],"properties":{"key":{"type":"string"},"title":{"type":"string"},"last_update":{"type":["string","integer"]},"markets":{"type":"array","items":{"type":"object","required":["key","last_update","outcomes"],"properties":{"key":{"type":"string","description":"h2h, spreads, totals, or a player_* prop key on the per-event route."},"last_update":{"type":["string","integer"]},"outcomes":{"type":"array","items":{"type":"object","required":["name","price"],"properties":{"name":{"type":"string"},"price":{"type":"number"},"point":{"type":"number"},"description":{"type":"string","description":"Player name on player prop outcomes."}}}}}}}}}}}},"OddsApiV4Score":{"type":"object","required":["id","sport_key","sport_title","commence_time","completed","home_team","away_team","scores","last_update"],"properties":{"id":{"type":"string"},"sport_key":{"type":"string"},"sport_title":{"type":"string"},"commence_time":{"type":["string","integer"]},"completed":{"type":"boolean"},"home_team":{"type":"string"},"away_team":{"type":"string"},"scores":{"type":["array","null"],"items":{"type":"object","required":["name","score"],"properties":{"name":{"type":"string"},"score":{"type":"string"}}}},"last_update":{"type":["string","integer","null"]}}},"OddsApiV4Error":{"type":"object","required":["message","error_code"],"properties":{"message":{"type":"string"},"error_code":{"type":"string"},"details_url":{"type":"string"}}},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}},"Market":{"type":"object","required":["id","source","market","line","player","league","starts_at","source_updated_at","observed_at","odds"],"properties":{"id":{"type":"string"},"source":{"type":"string","enum":["prizepicks","underdog","draftkings","fanduel"]},"market":{"type":"string"},"period":{"type":"string"},"line":{"type":"number"},"player":{"type":"string"},"league":{"type":["string","null"]},"starts_at":{"type":["string","null"],"format":"date-time"},"source_updated_at":{"type":["string","null"],"format":"date-time"},"observed_at":{"type":"string","format":"date-time"},"odds":{"type":"null","description":"Pick’em thresholds are not sportsbook prices."}}},"MarketResponse":{"type":"object","required":["data","meta","request_id"],"properties":{"request_id":{"type":"string","format":"uuid"},"data":{"type":"array","maxItems":200,"items":{"$ref":"#/components/schemas/Market"}},"meta":{"type":"object","required":["source","observed_at","source_updated_at","complete","availability"],"properties":{"source":{"type":"string","enum":["prizepicks","underdog","draftkings","fanduel"]},"observed_at":{"type":"string","format":"date-time"},"source_updated_at":{"type":"null"},"complete":{"const":false},"availability":{"type":"string"}}}}}}}}