/
v3.0.11Get access

betExplain

The bet_explain command triggers an AI-driven analysis of a settled bet. It retrieves detailed match data and tactical context to explain the logic behind why a specific selection resulted in a win or a loss. At least one of the possible parameters must be sent․

Request parameters:

NameDescriptionTypeValuesDefaultSource
team1Name
The name of the first participantstring--
Key from responseteam1
team2Name
The name of the second participant teamstring--
Key from responseteam2
marketName
The specific sub-marketstring--
Key from responsemarket_name
selectionName
The specific outcome the user placed the betstring--
Key from responseoutcome_name
This method is usually used with these methods:

Call example:

betExplain({
  team1Name: 'Manchester City',
  team2Name: 'West Ham',
  marketName: 'Total Goals 2.5',
  selectionName: 'Over'
})

Response examples:

{
  status: 'success',
  query: 'Manchester City vs West Ham, market Total Goals, selection \'Over\', Explain why I won or lost this bet..',
  event: {
    sport: 'Soccer',
    teams: ['Manchester City', 'West Ham'],
    market: 'Total Goals',
    line: 2.5,
    result: 'lost'
  },
  explanation: {
    verdict: 'Your bet on the Over market was settled as a loss because a total of 2 goals were scored in the match, which falls below common lines such as 2.5. If your specific line was 1.5, the bet would have won, but for standard lines like 2.5, the total output resulted in a loss.',
    summary: 'Manchester City and West Ham played to a 1-1 draw on March 14, 2026, resulting in a total of 2 goals. Bernardo Silva opened the scoring for City, followed shortly by an equalizing header from Konstantinos Mavropanos for West Ham.',
    factors: [{
      category: 'statistical',
      title: 'Match Goal Scoring',
      description: 'Bernardo Silva scored for Manchester City in the 31st minute, and Konstantinos Mavropanos equalized for West Ham in the 35th minute, resulting in 2 total goals.',
      confidence: 1,
      agreed_by: ['research_gemini_1', 'research_openai_2',
        'research_claude_3', 'research_grok_4', 'research_perplexity_5'
      ],
      sources: [{
        url: 'https://www.whufc.com/en/matches/mens-team/west-ham-united-fc-v-manchester-city-fc-premier-league-20260314',
        title: 'West Ham United vs Manchester City Match Report',
        snippet: null,
        cited_by: ['research_gemini_1']
      }, {
        url: 'https://www.espn.com/soccer/report/_/gameId/740895',
        title: 'West Ham 1-1 Man City (Mar 14, 2026) Game Analysis - ESPN',
        snippet: "Manchester City's title bid was left in tatters after a 1-1 draw at relegation-threatened West Ham",
        cited_by: ['research_claude_3', 'research_grok_4',
          'research_perplexity_5'
        ]
      }]
    }, {
      category: 'tactical',
      title: 'Manchester City Attacking Performance',
      description: "Despite Manchester City's heavy possession and 24 shot attempts, they struggled to convert opportunities, with Erling Haaland and other players missing key chances.",
      confidence: 0.95,
      agreed_by: ['research_openai_2', 'research_claude_3',
        'research_perplexity_5'
      ],
      sources: [{
        url: 'https://www.espn.com/soccer/match/_/gameId/740895/manchester-city-west-ham-united',
        title: 'West Ham 1-1 Man City (Mar 14, 2026) Final Score - ESPN',
        snippet: 'Possession 28.5% 71.5%, Shots on Goal 1 6, Shot Attempts 1 24, Corner Kicks 1 15',
        cited_by: ['research_perplexity_5']
      }]
    }]
  },
  sources: [{
    url: 'https://www.whufc.com/en/matches/mens-team/west-ham-united-fc-v-manchester-city-fc-premier-league-20260314',
    title: 'West Ham United vs Manchester City Match Report',
    snippet: null,
    cited_by: ['research_gemini_1']
  }, {
    url: 'https://www.espn.com/soccer/report/_/gameId/740895',
    title: 'West Ham 1-1 Man City (Mar 14, 2026) Game Analysis - ESPN',
    snippet: "Manchester City's title bid was left in tatters after a 1-1 draw at relegation-threatened West Ham",
    cited_by: ['research_claude_3', 'research_grok_4',
      'research_perplexity_5'
    ]
  }, {
    url: 'https://www.espn.com/soccer/match/_/gameId/740895/manchester-city-west-ham-united',
    title: 'West Ham 1-1 Man City (Mar 14, 2026) Final Score - ESPN',
    snippet: 'Possession 28.5% 71.5%, Shots on Goal 1 6, Shot Attempts 1 24, Corner Kicks 1 15',
    cited_by: ['research_perplexity_5']
  }],
  meta: {
    agents_used: 5,
    agents_succeeded: 5,
    total_latency_ms: 34647
  },
  raw_agents: null,
  is_correct: false,
  swarm: null,
  swarm_error: null
}

Response parameters:

NameDescriptionTypeValues
status
Indicates the success or failure of the requeststring-
query
A natural language representation of the request generated for the AI processorstring-
event
A summary of the match metadataobject
└─ sport
The name of the sports disciplinestring-
└─ teams
An array containing the names of the participantsarray-
└─ market
The specific betting market categorystring-
└─ line
Soonnumber-
└─ result
The final settlement status of the selectionstring"won" / "loss"
explanation
It translates sports data into a human-readable "why" for their bet outcomeobject
└─ verdict
The primary conclusion. It directly addresses the user's selection and explains the mathematical or logical reason for the final settlement (Win/Loss)string-
└─ summary
A narrative overview of the match. It provides the final score, match date, and key event highlights to give the user a complete picture of the game statestring-
└─ factors
Soonarray-
└─ category
Soonstring-
└─ title
Soonstring-
└─ description
Soonstring-
└─ confidence
Soonnumber-
└─ agreed_by
Soonstring-
└─ sources
Soonarray-
└─ url
The direct web link to the source article or match reportstring-
└─ title
The display title of the sourcestring-
└─ snippet
Soonstring-
└─ cited_by
Soonarray-
meta
Soonobject
└─ agents_used
Soonnumber-
└─ agents_succeeded
Soonnumber-
└─ total_latency_ms
Soonstring-
raw_agents
Soonstring-
is_correct
Soonbooleantrue / false
swarm
Soonstring-
swarm_error
Soonstring-
sources
These objects fulfill the regulatory requirement for transparency by showing exactly where the data came fromarray-
└─ url
The direct web link to the source article or reportstring-
└─ title
The direct web link to the source article or reportstring-
└─ snippet
Soonstring-
└─ cited_by
Soonstring-