> ## Documentation Index
> Fetch the complete documentation index at: https://rekko.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Analysis

> Get the latest AI analysis for a market, keyed by platform and market ID.



## OpenAPI

````yaml GET /v1/markets/{platform}/{market_id}/analysis
openapi: 3.1.0
info:
  title: Rekko AI — Prediction Market Intelligence
  description: >-
    The brain for prediction market trading. Deep AI research, Bayesian causal
    decomposition, portfolio-aware strategy signals, cross-platform arbitrage,
    and execution guidance — all in one API. Covers Kalshi, Polymarket,
    Robinhood, and Coinbase. Clean flat JSON designed for developers and
    autonomous trading agents.
  contact:
    name: Rekko AI
    url: https://rekko.ai/
  license:
    name: Proprietary
  version: 1.0.0
servers:
  - url: https://api.rekko.ai
security: []
tags:
  - name: Markets
    description: Prediction market listings, history, resolution, and execution guidance
  - name: Insights
    description: AI-powered research insights with causal decomposition
  - name: Strategy
    description: >-
      Actionable trading signals with Kelly-derived position sizing and causal
      decomposition
  - name: Portfolio
    description: Portfolio-aware strategy, correlation analysis, and hedge recommendations
  - name: Arbitrage
    description: Cross-platform arbitrage detection (Kalshi vs Polymarket vs Robinhood)
  - name: Analytics
    description: Calibration metrics, sentiment, and performance tracking
  - name: Streaming
    description: Real-time SSE event stream and webhooks
  - name: Consensus
    description: Agent trade aggregation and crowd probability
paths:
  /v1/markets/{platform}/{market_id}/analysis:
    get:
      tags:
        - Insights
      summary: Get latest analysis for a market
      description: >-
        Get the latest AI analysis for a market, keyed by platform and market
        ID.
      operationId: /v1/markets/{platform}/{market_id}/analysis
      parameters:
        - name: platform
          in: path
          required: true
          schema:
            type: string
            examples:
              - kalshi
            title: Platform
        - name: market_id
          in: path
          required: true
          schema:
            type: string
            examples:
              - KXAGICO-COMP-28Q1
            title: Market Id
        - name: expand
          in: query
          required: false
          schema:
            type: string
            description: Comma-separated expansions
            default: ''
            title: Expand
          description: Comma-separated expansions
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Analysis'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    Analysis:
      properties:
        platform:
          type: string
          title: Platform
          description: kalshi, polymarket, robinhood, or coinbase
        market_id:
          type: string
          title: Market Id
          description: Platform-specific market identifier
        title:
          type: string
          title: Title
          description: Market question
        probability:
          type: number
          maximum: 1
          minimum: 0
          title: Probability
          description: Rekko's estimated true probability
        confidence:
          type: number
          maximum: 1
          minimum: 0
          title: Confidence
          description: Confidence in the estimate
        edge:
          type: number
          title: Edge
          description: estimated_prob - market_price (positive = underpriced YES)
          default: 0
        recommendation:
          type: string
          title: Recommendation
          description: BUY_YES, BUY_NO, or NO_TRADE
        risk_rating:
          type: string
          title: Risk Rating
          description: low, medium, or high
          default: medium
        summary:
          type: string
          title: Summary
          description: Executive summary of the analysis
        key_factors:
          items:
            type: string
          type: array
          title: Key Factors
          description: Top probability drivers
        risks:
          items:
            type: string
          type: array
          title: Risks
          description: Ways the analysis could be wrong
        source_count:
          type: integer
          title: Source Count
          description: Number of sources analyzed
          default: 0
        analyzed_at:
          type: string
          format: date-time
          title: Analyzed At
          description: When the analysis was produced
        expires_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Expires At
          description: Signal staleness window
        freshness:
          anyOf:
            - type: string
              enum:
                - fresh
                - stale
                - expired
            - type: 'null'
          title: Freshness
          description: 'Data freshness: fresh (<24h), stale (24-72h), expired (>72h)'
        analysis_type:
          anyOf:
            - type: string
              enum:
                - full
                - light
            - type: 'null'
          title: Analysis Type
          description: Whether this was a full 4-stage or light 2-call analysis
        scenarios:
          anyOf:
            - items:
                $ref: '#/components/schemas/AnalysisScenario'
              type: array
            - type: 'null'
          title: Scenarios
          description: Bull/base/bear scenarios (?expand=scenarios)
        causal:
          anyOf:
            - $ref: '#/components/schemas/CausalDecomposition'
            - type: 'null'
          description: Causal factor decomposition (?expand=causal)
        meta:
          anyOf:
            - $ref: '#/components/schemas/AnalysisMeta'
            - type: 'null'
          description: Pipeline metadata (?expand=meta)
      type: object
      required:
        - platform
        - market_id
        - title
        - probability
        - confidence
        - recommendation
        - summary
      title: Analysis
      description: |-
        AI-generated research analysis for a prediction market.

        Core fields are always present. Detailed breakdowns available
        via ?expand=scenarios,causal,meta.
      example:
        analyzed_at: '2026-03-21T12:00:00Z'
        confidence: 0.82
        edge: 0.09
        expires_at: '2026-03-22T12:00:00Z'
        key_factors:
          - PCE inflation at 2.1% — within Fed target range
          - Three FOMC members signaled openness to cuts in recent speeches
          - Jobless claims trending upward (225K → 238K over 4 weeks)
        market_id: KXFED-26MAR19
        platform: kalshi
        probability: 0.71
        recommendation: BUY_YES
        risk_rating: low
        risks:
          - Strong March employment report could reverse dovish signals
          - Tariff escalation could reignite inflation expectations
        source_count: 14
        summary: >-
          Fed futures imply 68% probability of a March cut. PCE inflation at
          2.1% is within the Fed's comfort zone, and three FOMC members have
          signaled openness to easing. Our research across 14 sources estimates
          71% true probability — a 9-point edge over the current market price of
          62c.
        title: Will the Fed cut rates at the March 2026 meeting?
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    AnalysisScenario:
      properties:
        name:
          type: string
          title: Name
          description: Scenario name, e.g. 'Bull (rate cut)'
        probability:
          type: number
          maximum: 1
          minimum: 0
          title: Probability
          description: Scenario probability
        description:
          type: string
          title: Description
          description: What happens in this scenario
        trigger:
          type: string
          title: Trigger
          description: Events that trigger this scenario
          default: ''
      type: object
      required:
        - name
        - probability
        - description
      title: AnalysisScenario
      description: A scenario assessment (bull/base/bear).
      example:
        description: >-
          Fed delivers 25bp cut citing cooling inflation and softening labor
          market
        name: Bull (rate cut)
        probability: 0.71
        trigger: PCE stays below 2.2%, jobless claims rise above 230K
    CausalDecomposition:
      properties:
        overall_probability:
          type: number
          maximum: 1
          minimum: 0
          title: Overall Probability
          description: Aggregated probability from factor weights
        overall_confidence:
          type: number
          maximum: 1
          minimum: 0
          title: Overall Confidence
          description: Weighted confidence across all factors
        factors:
          items:
            $ref: '#/components/schemas/CausalFactor'
          type: array
          title: Factors
          description: Causal factors (typically 3-7)
        method:
          type: string
          title: Method
          description: 'Aggregation method: weighted_bayesian, linear, log_odds'
          default: weighted_bayesian
        generated_at:
          type: string
          format: date-time
          title: Generated At
          description: When this decomposition was produced
      type: object
      required:
        - overall_probability
        - overall_confidence
        - factors
      title: CausalDecomposition
      description: |-
        Weighted causal decomposition of a market probability estimate.

        Breaks a probability estimate into evidence-backed factors with
        Bayesian prior/posterior updates.
      example:
        factors:
          - claim: Inflation is within Fed's comfort zone
            confidence: 0.9
            direction: supports_yes
            evidence:
              - 'PCE Feb 2026: 2.1%'
              - Core CPI declining 3 months
            posterior: 0.82
            prior: 0.6
            weight: 0.35
          - claim: Fed rhetoric is dovish
            confidence: 0.75
            direction: supports_yes
            evidence:
              - Waller speech March 12
              - 'Bostic: ''open to adjustment'''
            posterior: 0.68
            prior: 0.5
            weight: 0.3
          - claim: Tariff uncertainty creates headwinds
            confidence: 0.6
            direction: supports_no
            evidence:
              - New tariffs announced March 5
              - Trade deficit widening
            posterior: 0.45
            prior: 0.4
            weight: 0.2
        generated_at: '2026-03-21T12:00:00Z'
        method: weighted_bayesian
        overall_confidence: 0.82
        overall_probability: 0.71
    AnalysisMeta:
      properties:
        what_would_change_mind:
          items:
            type: string
          type: array
          title: What Would Change Mind
          description: Events that would change the recommendation
        edge_assessment:
          type: string
          title: Edge Assessment
          description: Market edge analysis
          default: ''
        models_used:
          items:
            type: string
          type: array
          title: Models Used
          description: Models used in the pipeline
        duration_ms:
          type: integer
          title: Duration Ms
          description: How long the analysis took
          default: 0
        ensemble_probability:
          anyOf:
            - type: number
              maximum: 1
              minimum: 0
            - type: 'null'
          title: Ensemble Probability
          description: Aggregated probability from multi-model ensemble
        ensemble_estimates:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          title: Ensemble Estimates
          description: Per-model probability estimates from ensemble
        ensemble_method:
          anyOf:
            - type: string
            - type: 'null'
          title: Ensemble Method
          description: Ensemble aggregation method used
        ensemble_disagreement:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
          title: Ensemble Disagreement
          description: Std dev across ensemble models (0 = full agreement)
        raw_probability:
          anyOf:
            - type: number
              maximum: 1
              minimum: 0
            - type: 'null'
          title: Raw Probability
          description: Pre-calibration probability (before Platt scaling)
        calibration_applied:
          type: boolean
          title: Calibration Applied
          description: Whether post-hoc Platt scaling was applied
          default: false
      type: object
      title: AnalysisMeta
      description: >-
        Internal metadata about how an analysis was produced (opt-in via
        ?expand=meta).
      example:
        calibration_applied: true
        duration_ms: 42300
        edge_assessment: >-
          Market at 62c implies 62% probability. Our 71% estimate gives +9c edge
          — significant at this confidence level.
        ensemble_disagreement: 0.04
        ensemble_method: trimmed_median
        ensemble_probability: 0.72
        models_used:
          - gemini-3.1-pro-preview
          - claude-sonnet-4-5
        raw_probability: 0.7
        what_would_change_mind:
          - CPI surprise above 2.5%
          - Strong employment report (NFP > 250K)
          - Hawkish Fed minutes release
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    CausalFactor:
      properties:
        claim:
          type: string
          title: Claim
          description: The factor statement, e.g. 'Fed will hold rates'
        direction:
          type: string
          enum:
            - supports_yes
            - supports_no
            - neutral
          title: Direction
          description: Whether this factor pushes toward YES or NO resolution
        weight:
          type: number
          maximum: 1
          minimum: 0
          title: Weight
          description: Relative importance weight (top-level factors sum to ~1.0)
        confidence:
          type: number
          maximum: 1
          minimum: 0
          title: Confidence
          description: Confidence in this specific factor (0=uncertain, 1=certain)
        prior:
          type: number
          maximum: 1
          minimum: 0
          title: Prior
          description: Prior probability (base rate)
        posterior:
          type: number
          maximum: 1
          minimum: 0
          title: Posterior
          description: Updated probability after evidence (Bayesian posterior)
        evidence:
          items:
            type: string
          type: array
          title: Evidence
          description: Key evidence supporting this factor
      type: object
      required:
        - claim
        - direction
        - weight
        - confidence
        - prior
        - posterior
      title: CausalFactor
      description: A single factor in a causal decomposition.
      example:
        claim: Inflation is within Fed's comfort zone
        confidence: 0.9
        direction: supports_yes
        evidence:
          - 'PCE Feb 2026: 2.1% (below 2.5% target ceiling)'
          - Core CPI declining for 3 consecutive months
        posterior: 0.82
        prior: 0.6
        weight: 0.35

````