MoneyLine AI

curl -X POST https://mlapi.bet/v1/ai/chat \
  -H "content-type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "scope": "small",
    "responseFormat": "hybrid",
    "messages": [
      { "role": "user", "content": "I want to bet on hockey this weekend and I am only using FanDuel. What is the best bet for me?" }
    ]
  }'

{
  "success": true,
  "data": {
    "records": [...],
    "context": {
      "requestedContext": null,
      "resolvedContext": "event_best_available_bet",
      "inferred": true,
      "scope": "small",
      "responseFormat": "hybrid",
      "filters": {}
    },
    "sources": {
      "primary": "event_recommendation",
      "label": "Event Recommendation",
      "filters": {}
    },
    "presentation": {
      "version": "v1",
      "responseType": "event_recommendation",
      "headline": "MoneyLine AI Recommendation for Boston Celtics at Atlanta Hawks",
      "summary": "For Boston Celtics at Atlanta Hawks, MoneyLine recommends Atlanta Hawks +4.5 in the spread market at -108 from FanDuel.",
      "confidence": "high",
      "entity": { "...": "..." },
      "primaryPick": { "...": "..." },
      "alternativePick": { "...": "..." },
      "cards": [{ "...": "..." }]
    },
    "answer": "Only for natural and hybrid formats.",
    "analysis": "Only for structured format.",
    "primaryRecommendation": "Present on event-specific workflows.",
    "alternativeRecommendation": "Present when a stronger same-league option exists."
  },
  "meta": {
    "creditUsage": {
      "total": 41,
      "retrieval": 14,
      "generation": 27
    }
  }
}

Use MoneyLine's data.presentation object as the authoritative UI contract.

Ignore these fields for end-user presentation:
- meta.creditUsage
- meta.requestId
- meta.degraded
- data.context
- data.sources
- data.records
- data.primaryRecommendation
- data.alternativeRecommendation
- data.alternativeRecords
- data.entityResolution

Only use those ignored fields for logging, debugging, support, or drill-down.

Render order:
1. data.presentation.headline as the top title.
2. data.presentation.summary as the short plain-English overview.
3. data.presentation.primaryPick as the main recommendation block.
4. data.presentation.alternativePick as a secondary option only if present.
5. data.presentation.cards as supporting evidence cards in the order provided.
6. data.answer or data.analysis.summary as optional expanded explanation below the main recommendation.

Field meanings:
- data.presentation.responseType
  - surface_summary: general best-bet, EV, value, or arbitrage summary across surfaced MoneyLine records.
  - event_recommendation: recommendation for a specific game, matchup, or player-linked event.
- data.presentation.headline: ready-to-render title.
- data.presentation.summary: ready-to-render short summary; use this as the default explanatory sentence.
- data.presentation.confidence: high, medium, or low; reflect this in wording and emphasis, but do not invent stronger certainty.
- data.presentation.entity: event context for event-specific flows.
- data.presentation.entity.matchup: human-readable event label.
- data.presentation.primaryPick: the single most important bet to show first.
- data.presentation.alternativePick: backup option if present.
- data.presentation.cards: supporting picks or evidence; preserve order and do not re-rank.
- data.presentation.sourceLabel: human-readable MoneyLine source label such as Best Bets, EV Bets, or Event Recommendation.

Primary pick and alternative pick meanings:
- signalType: machine type such as best_bet, value_bet, ev_bet, arbitrage, hit_rate, or fallback.
- hit_rate signalType: indicates a player prop chosen primarily on recent L5/L10/L25 hit-rate strength. humanInsight.summary cites the hits-per-games fragments and any concurrent EV or edge enrichment. metrics.hitRate carries the L5/L10/L25/season windows for chip rendering.
- signalLabel: human label for the signal type.
- selection: the cleanest label for what to bet; use this as the main pick text.
- market: betting market such as moneyline, spread, total, or prop market.
- marketLabel: human-readable market label such as Moneyline, Run Line, Puck Line, Total Runs, Total Goals, Total Points, or Points. Use this whenever selection alone is ambiguous.
- event: normalized game or matchup context for the suggested bet.
- event.matchup: human-readable matchup label tied to the suggested bet.
- event.startTime: ISO start time for the game or matchup tied to the suggested bet.
- outcome: raw side, team, or player outcome.
- point: line value when applicable.
- odds: numeric American odds.
- oddsDisplay: preformatted American odds string; prefer this for display.
- bookmakerName: sportsbook or source name.
- bookmakerId: internal source id; not necessary for end-user display.
- sourceType: sportsbook, exchange, or dfs; useful as supporting metadata.
- confidence: confidence for this pick.
- rationale: concise reason to show under the pick.
- humanInsight: deterministic explanation layer written for non-expert users.
- humanInsight.summary: the default plain-English sentence to show under the pick.
- humanInsight.confidenceReason: one short line explaining why MoneyLine is confident in this signal.
- humanInsight.keyNumbers: labeled stats ready for chips, badges, or small comparison rows.
- humanInsight.supportingPoints: optional extra lines expanding the case for the bet.
- humanInsight.riskNote: optional caution line, mainly for narrow fallback scenarios where no positive edge exists.
- metrics: structured supporting stats.

Metrics meanings:
- edgePct: model edge versus market consensus.
- evPct: expected value percentage.
- ev: expected value per unit stake.
- profitPct: guaranteed arbitrage return percentage.
- guaranteedProfit: guaranteed profit amount from arbitrage math.
- impliedProb: probability implied by the market odds.
- modelProb: MoneyLine projected probability.

Card meanings:
- recordIndex: index into data.records; use only for traceability.
- signalType, signalLabel, selection, market, marketLabel, event, oddsDisplay, bookmakerName, confidence, reason, and metrics should be rendered similarly to the main pick, but as supporting evidence rather than the featured pick.

Narrative fields:
- If data.answer exists, it is a prose explanation for natural and hybrid responses.
- If data.analysis exists, use data.analysis.summary and data.analysis.highlights for structured responses.
- Never let data.answer or data.analysis override data.presentation. If there is any mismatch, trust data.presentation.

Formatting rules:
- Show exactly one featured recommendation from primaryPick.
- Show alternativePick only if present.
- Show all returned cards, preserving API order.
- Do not invent odds, books, confidence, or metrics when fields are missing.
- Omit empty sections entirely.
- Keep explanation text grounded in summary, rationale, reason, and metrics.
- Prefer primaryPick.humanInsight.summary over ad-libbed explanatory copy when you want a confident, non-expert-friendly explanation.
- Render humanInsight.keyNumbers in the order returned and do not invent additional stat chips.
- Treat selection + marketLabel + oddsDisplay + bookmakerName as the core readable recommendation tuple.
- If selection is a short value like Over 8.5 or Under 2.5, always pair it with marketLabel so the end user knows what the total or prop refers to.
- When available, use primaryPick.event.matchup and primaryPick.event.startTime as the source of truth for the game label and scheduled date/time.

const event = data.presentation.primaryPick?.event ?? data.presentation.cards?.[0]?.event;

const matchup = event?.matchup ?? null;
const startTime = event?.startTime ?? null;

const formattedStartTime = startTime
  ? new Intl.DateTimeFormat("en-US", {
      weekday: "short",
      month: "short",
      day: "numeric",
      hour: "numeric",
      minute: "2-digit",
      timeZone: "America/New_York",
      timeZoneName: "short",
    }).format(new Date(startTime))
  : null;

// Example output:
// matchup => "Cleveland Guardians at Atlanta Braves"
// formattedStartTime => "Fri, Apr 10, 7:20 PM EDT"

const res = await fetch("https://mlapi.bet/v1/ai/chat", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "x-api-key": "YOUR_API_KEY"
  },
  body: JSON.stringify({
    context: "arbitrage",
    scope: "small",
    responseFormat: "structured",
    filters: { league: "nba", sourceType: "all" },
    messages: [
      { role: "user", content: "Rank the top arbitrage spots and tell me which records are most actionable." }
    ]
  })
})

const payload = await res.json()
console.log(payload.data.analysis)
console.log(payload.data.records)

const res = await fetch("https://mlapi.bet/v1/ai/chat", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "x-api-key": "YOUR_API_KEY"
  },
  body: JSON.stringify({
    context: "event_best_available_bet",
    scope: "small",
    responseFormat: "hybrid",
    messages: [
      { role: "user", content: "Show me the best bet for the Hawks game tonight. If that game is weak, tell me what I should bet in the NBA instead." }
    ]
  })
})

const payload = await res.json()
console.log(payload.data.primaryRecommendation)
console.log(payload.data.alternativeRecommendation)
console.log(payload.data.answer)

{
  "success": true,
  "data": {
    "answer": "For the Braves game, the strongest current option on FanDuel is Atlanta Braves moneyline at +118. If you want the better overall MLB spot instead, look at the Cubs moneyline at +132.",
    "records": [
      {
        "recordType": "best_bet",
        "eventId": "mlb-ev-1329189120",
        "leagueId": "mlb",
        "sport": "baseball",
        "calculatedAt": "2026-04-07T01:18:16.945Z",
        "market": "moneyline",
        "outcome": "Atlanta Braves",
        "bestOdds": 118,
        "bookmakerId": "fanduel",
        "bookmakerName": "FanDuel",
        "sourceType": "sportsbook",
        "sourceRegion": "us"
      }
    ],
    "context": {
      "requestedContext": null,
      "resolvedContext": "event_best_available_bet",
      "inferred": true,
      "scope": "small",
      "responseFormat": "hybrid",
      "filters": {
        "bookmakers": ["fanduel"]
      }
    },
    "sources": {
      "primary": "event_recommendation",
      "label": "Event Recommendation",
      "filters": {
        "bookmakers": ["fanduel"]
      }
    },
    "presentation": {
      "version": "v1",
      "responseType": "event_recommendation",
      "headline": "MoneyLine AI Recommendation for Atlanta Braves at New York Mets",
      "summary": "For Atlanta Braves at New York Mets, MoneyLine recommends Atlanta Braves in the moneyline market at +118 from FanDuel. Best available line surfaced from MoneyLine best-bets data. If you want the stronger same-league alternative, look at Chicago Cubs in the moneyline market at +132 from FanDuel.",
      "confidence": "medium",
      "entity": {
        "resolvedEntityType": "event",
        "resolvedEventId": "mlb-ev-1329189120",
        "resolvedLeagueId": "mlb",
        "resolutionConfidence": "medium",
        "resolutionReason": "Resolved from team/game language in the prompt.",
        "matchup": "Atlanta Braves at New York Mets"
      },
      "primaryPick": {
        "signalType": "best_bet",
        "signalLabel": "Best Bet",
        "type": "surface",
        "eventId": "mlb-ev-1329189120",
        "leagueId": "mlb",
        "market": "moneyline",
        "marketLabel": "Moneyline",
        "selection": "Atlanta Braves",
        "outcome": "Atlanta Braves",
        "odds": 118,
        "oddsDisplay": "+118",
        "bookmakerName": "FanDuel",
        "bookmakerId": "fanduel",
        "sourceType": "sportsbook",
        "confidence": "medium",
        "rationale": "Best available line surfaced from MoneyLine best-bets data.",
        "metrics": {}
      },
      "alternativePick": {
        "signalType": "ev_bet",
        "signalLabel": "EV Bet",
        "type": "surface",
        "eventId": "mlb-ev-1329189109",
        "leagueId": "mlb",
        "market": "moneyline",
        "marketLabel": "Moneyline",
        "selection": "Chicago Cubs",
        "outcome": "Chicago Cubs",
        "odds": 132,
        "oddsDisplay": "+132",
        "bookmakerName": "FanDuel",
        "bookmakerId": "fanduel",
        "sourceType": "sportsbook",
        "confidence": "high",
        "rationale": "Positive EV opportunity with 6.4% expected value.",
        "metrics": {
          "ev": 0.064,
          "evPct": 6.4
        }
      },
      "cards": [
        {
          "recordIndex": 0,
          "signalType": "best_bet",
          "signalLabel": "Best Bet",
          "selection": "Atlanta Braves",
          "market": "moneyline",
          "marketLabel": "Moneyline",
          "odds": 118,
          "oddsDisplay": "+118",
          "bookmakerName": "FanDuel",
          "confidence": "medium",
          "reason": "Best currently available market price from FanDuel.",
          "metrics": {}
        }
      ],
      "reasoningMode": "hybrid_surface_plus_fallback",
      "sourceLabel": "Event Recommendation"
    },
    "primaryRecommendation": {
      "type": "surface",
      "premiumSignalType": "best_bet",
      "eventId": "mlb-ev-1329189120",
      "leagueId": "mlb",
      "market": "moneyline",
      "selection": "Atlanta Braves",
      "outcome": "Atlanta Braves",
      "bookmakerId": "fanduel",
      "bookmakerName": "FanDuel",
      "sourceType": "sportsbook",
      "sourceRegion": "us",
      "odds": 118,
      "confidence": "medium",
      "why": "Best available line surfaced from MoneyLine best-bets data.",
      "metrics": {}
    },
    "alternativeRecommendation": {
      "type": "surface",
      "premiumSignalType": "ev_bet",
      "eventId": "mlb-ev-1329189109",
      "leagueId": "mlb",
      "market": "moneyline",
      "selection": "Chicago Cubs",
      "outcome": "Chicago Cubs",
      "bookmakerId": "fanduel",
      "bookmakerName": "FanDuel",
      "sourceType": "sportsbook",
      "sourceRegion": "us",
      "odds": 132,
      "confidence": "high",
      "why": "Positive EV opportunity with 6.4% expected value.",
      "whyBetterThanPrimary": "This same-league option has a stronger surfaced MoneyLine edge than the requested game.",
      "metrics": {
        "ev": 0.064,
        "evPct": 6.4
      }
    },
    "alternativeRecords": [
      {
        "recordType": "ev_bet",
        "eventId": "mlb-ev-1329189109",
        "leagueId": "mlb",
        "sport": "baseball",
        "calculatedAt": "2026-04-07T01:18:13.912Z",
        "edgeId": "ev-1775523493902-fanduel",
        "market": "moneyline",
        "outcome": "Chicago Cubs",
        "sourceType": "sportsbook",
        "sourceRegion": "us",
        "bookmakerName": "FanDuel",
        "bookmakerId": "fanduel",
        "odds": 132,
        "ev": 0.064,
        "evPct": 6.4
      }
    ],
    "reasoningMode": "hybrid_surface_plus_fallback",
    "entityResolution": {
      "resolvedEntityType": "event",
      "resolvedEventId": "mlb-ev-1329189120",
      "resolvedLeagueId": "mlb",
      "resolutionConfidence": "medium",
      "resolutionReason": "Resolved from team/game language in the prompt."
    }
  },
  "meta": {
    "creditUsage": {
      "total": 41,
      "retrieval": 14,
      "generation": 27
    },
    "requestId": "ml_req_example123"
  },
  "error": null
}

{
  "success": false,
  "data": null,
  "meta": {
    "requestId": "ml_req_ab12cd34ef56"
  },
  "error": {
    "message": "Your request appears to match multiple MoneyLine AI contexts. Resend with an explicit \"context\" value.",
    "statusCode": 400
  }
}