> ## 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 Event

> Get a single event with aggregate stats and optionally all its markets.

Use ?expand=markets to include individual outcome markets in the response.



## OpenAPI

````yaml GET /v1/events/{slug}
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/events/{slug}:
    get:
      tags:
        - Markets
      summary: Get event details
      description: >-
        Get a single event with aggregate stats and optionally all its markets.


        Use ?expand=markets to include individual outcome markets in the
        response.
      operationId: /v1/events/{slug}
      parameters:
        - name: slug
          in: path
          required: true
          schema:
            type: string
            maxLength: 200
            description: Event slug (e.g., 'kalshi:kxtrumpadminleave-26dec31')
            title: Slug
          description: Event slug (e.g., 'kalshi:kxtrumpadminleave-26dec31')
        - name: expand
          in: query
          required: false
          schema:
            type: string
            maxLength: 100
            description: 'Comma-separated expansions: ''markets'''
            default: ''
            title: Expand
          description: 'Comma-separated expansions: ''markets'''
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Event'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    Event:
      properties:
        slug:
          type: string
          title: Slug
          description: URL-safe event identifier (e.g., 'kalshi:kxtrumpadminleave-26dec31')
        title:
          type: string
          title: Title
          description: Event question (e.g., 'Who will leave the Trump administration?')
        description:
          type: string
          title: Description
          description: Event subtitle or description
          default: ''
        category:
          type: string
          title: Category
          description: Event category (politics, economics, sports, etc.)
          default: ''
        platform:
          type: string
          title: Platform
          description: Primary platform (kalshi, polymarket)
        market_count:
          type: integer
          minimum: 0
          title: Market Count
          description: Number of individual outcome markets in this event
        total_volume_24h:
          type: number
          minimum: 0
          title: Total Volume 24H
          description: Aggregate 24h volume across all markets in USD
        top_yes_price:
          anyOf:
            - type: number
              maximum: 1
              minimum: 0
            - type: 'null'
          title: Top Yes Price
          description: Highest-probability outcome price
        mutually_exclusive:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Mutually Exclusive
          description: >-
            Whether outcomes are mutually exclusive (probabilities should sum to
            ~1.0)
        status:
          type: string
          title: Status
          description: 'Event status: open, closed, settled'
          default: open
        end_date:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: End Date
          description: When the event resolves/expires
        featured:
          type: boolean
          title: Featured
          description: Platform is actively promoting this event
          default: false
        also_on:
          items:
            $ref: '#/components/schemas/EventPlatformPresence'
          type: array
          title: Also On
          description: >-
            Same event on other platforms (cross-platform linking via embedding
            similarity)
        markets:
          anyOf:
            - items:
                $ref: '#/components/schemas/EventMarketSummary'
              type: array
            - type: 'null'
          title: Markets
          description: Individual outcome markets (include with ?expand=markets)
        updated_at:
          type: string
          format: date-time
          title: Updated At
          description: When aggregate stats were last refreshed
      type: object
      required:
        - slug
        - title
        - platform
        - market_count
        - total_volume_24h
        - updated_at
      title: Event
      description: |-
        Prediction market event grouping related outcome markets.

        An event like "Who will leave the Trump administration?" contains
        multiple individual markets (one per potential leaver). This model
        aggregates them with pre-computed stats.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    EventPlatformPresence:
      properties:
        platform:
          type: string
          title: Platform
          description: Platform name (kalshi, polymarket, etc.)
        event_id:
          type: string
          title: Event Id
          description: Platform-specific event identifier
        url:
          type: string
          title: Url
          description: Event page URL on this platform
          default: ''
        market_count:
          type: integer
          minimum: 0
          title: Market Count
          description: Number of markets on this platform
          default: 0
      type: object
      required:
        - platform
        - event_id
      title: EventPlatformPresence
      description: Cross-platform availability for an event.
    EventMarketSummary:
      properties:
        market_id:
          type: string
          title: Market Id
          description: Platform-specific market identifier
        title:
          type: string
          title: Title
          description: Outcome title (e.g., 'Pam Bondi', 'At least 80 days')
        yes_price:
          type: number
          maximum: 1
          minimum: 0
          title: Yes Price
          description: Current YES probability
        volume_24h:
          type: number
          minimum: 0
          title: Volume 24H
          description: 24h volume in USD
          default: 0
        url:
          type: string
          title: Url
          description: Platform page URL for this market
          default: ''
        open_interest:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
          title: Open Interest
          description: Open interest (contracts outstanding)
        spread:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
          title: Spread
          description: Bid-ask spread (yes_ask - yes_bid)
      type: object
      required:
        - market_id
        - title
        - yes_price
      title: EventMarketSummary
      description: Individual outcome market within an event (compact).
    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

````