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

# List Events

> List prediction market events grouped with aggregate stats.

Events group related individual markets (e.g., "Who will leave the Trump
administration?" groups 32 individual outcome markets). Sorted by
aggregate 24h volume descending.



## OpenAPI

````yaml GET /v1/events
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:
    get:
      tags:
        - Markets
      summary: List prediction market events
      description: |-
        List prediction market events grouped with aggregate stats.

        Events group related individual markets (e.g., "Who will leave the Trump
        administration?" groups 32 individual outcome markets). Sorted by
        aggregate 24h volume descending.
      operationId: /v1/events
      parameters:
        - name: source
          in: query
          required: false
          schema:
            type: string
            maxLength: 20
            pattern: ^(kalshi|polymarket|robinhood|)$
            description: Filter by platform
            default: ''
            title: Source
          description: Filter by platform
        - name: category
          in: query
          required: false
          schema:
            type: string
            maxLength: 50
            description: Filter by category (e.g., 'politics', 'crypto')
            default: ''
            title: Category
          description: Filter by category (e.g., 'politics', 'crypto')
        - name: featured
          in: query
          required: false
          schema:
            anyOf:
              - type: boolean
              - type: 'null'
            description: Only featured events (true) or all (omit)
            title: Featured
          description: Only featured events (true) or all (omit)
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            description: Maximum events to return
            default: 20
            title: Limit
          description: Maximum events to return
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/EventSummary'
                title: Response /V1/Events
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    EventSummary:
      properties:
        slug:
          type: string
          title: Slug
          description: URL-safe event identifier
        title:
          type: string
          title: Title
          description: Event question
        category:
          type: string
          title: Category
          description: Event category
          default: ''
        platform:
          type: string
          title: Platform
          description: Primary platform
        market_count:
          type: integer
          minimum: 0
          title: Market Count
          description: Number of outcome markets
        total_volume_24h:
          type: number
          minimum: 0
          title: Total Volume 24H
          description: Aggregate 24h volume in USD
        featured:
          type: boolean
          title: Featured
          description: Platform-promoted event
          default: false
        updated_at:
          type: string
          format: date-time
          title: Updated At
          description: Last refresh timestamp
      type: object
      required:
        - slug
        - title
        - platform
        - market_count
        - total_volume_24h
        - updated_at
      title: EventSummary
      description: Compact event summary for list endpoints.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    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

````