events

Get bet intelligence for an event

get/v1/events/{event_id}/intelligence

Request

  • Base URL: https://lumify.ai
  • URL: https://lumify.ai/v1/events/{event_id}/intelligence
  • Auth: HTTP bearer

Path parameters

event_idinteger required

Lumify event ID

Query parameters

bookmakerstring nullable

Ignored. Intelligence always reports the book the assessment was priced against. Accepted values (pinnacle, fanduel, draftkings, betmgm, caesars, bet365, circa, westgate, wynn, south_point, stations, hardrock, betonline, betr, betrivers, lowvig, bovada) are kept for compatibility and do not change market.price or fair_price.

Response

Predictive bet intelligence: vig-stripped probability, fair_price, Price overlay (fair / edges_by_book / best), and main-line ev (Beta), plus forecasts[] — forecasted wagers from the model (same objects as GET /v1/intelligence/forecasts; player props on MLB/NFL/NCAAF/NBA/NCAAB/NHL, tennis moneyline/spreads/totals). bets[] is live for MLB, tennis, soccer (MLS + big-five), NFL, and NCAAF. forecasts[] covers MLB, NFL, NCAAF, NBA, NCAAB, NHL, and tennis (can populate when available is false). Today bets[] is fair-price + line-shopping (edge/tier null; has_recommend false). The bookmaker query is ignored — prices are the book the assessment was priced against. Match-level tokens (OVER, UNDER, ML_DRAW) have null player/team attribution. Free only when available is false and forecasts is empty. Field catalog: https://lumify.ai/docs/reference#event-intelligence

event_idinteger nullable

Lumify event ID this intelligence describes. Present on the standalone endpoint; omitted when inlined under an event via include_intelligence.

availableboolean

False when no predictive bets[] have been computed for this event yet. forecasts[] can still populate on MLB / NFL / NCAAF / NBA / NCAAB / NHL / tennis. The request is free only when available is false and forecasts is empty.

odds_sourcestring nullable

Bookmaker bets[].market prices were sourced from. For predictive intelligence this is the assessment's market_book (not a live ?bookmaker= overlay).

sportstring nullable

Sport slug for this event.

leaguestring nullable

League slug for this event, if any.

playersobject

Home/away (or p1/p2) participant identification, keyed by role: {role: {name, player_id, team_id}}.

has_recommendboolean nullable

True when at least one bet meets the recommendation threshold; false when none do; null when intelligence has not been computed for this event. For predictive-framework sports a recommendation requires a non-null tier derived from edge, so this is false while Edge is not yet published (current MLB/soccer/tennis Stage 1).

match_overviewstring nullable

Natural-language pre-game preview of the matchup — form, context, and what to watch. Written before kickoff by a Search-backed overlay on every event sport (MLB, NFL, NCAAF, NBA, NCAAB, NHL, soccer, tennis); sport-shaped queries so tennis does not invent pitchers. The request path only reads the stored row. Null when the pre-kickoff job has not run or the fixture was not eligible.

rationalestring[] nullable

Event-level factual pre-game matchup chips (injuries, recent form, lineup/availability news — sport-shaped). Written before kickoff; the request path only reads the stored row. Null when not generated.

intelligence_updated_atstring nullable

ISO-8601 UTC timestamp of the most recent change anywhere in this payload — the maximum of the per-bet computed_at values for predictive-framework sports. Because individual markets are only rewritten when they move, use the per-bet computed_at to reason about a specific bet rather than this event-level maximum.

matchupobject nullable

Not returned. Use GET /v1/events/{id}/stats for pitcher/lineup Data.

Changes

No recorded changes to this operation across all 1 revision of this API.