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

> List current prediction markets with pricing data.

Use ?query= to search by keyword (e.g. ?query=bitcoin).
Use ?source= to filter by platform.



## OpenAPI

````yaml GET /v1/markets
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:
    get:
      tags:
        - Markets
      summary: List prediction markets
      description: |-
        List current prediction markets with pricing data.

        Use ?query= to search by keyword (e.g. ?query=bitcoin).
        Use ?source= to filter by platform.
      operationId: /v1/markets
      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: query
          in: query
          required: false
          schema:
            type: string
            maxLength: 500
            description: Search markets by keyword in title (case-insensitive)
            default: ''
            title: Query
          description: Search markets by keyword in title (case-insensitive)
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            minimum: 1
            description: Maximum markets to return
            default: 30
            title: Limit
          description: Maximum markets to return
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Market'
                title: Response /V1/Markets
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    Market:
      properties:
        platform:
          type: string
          title: Platform
          description: kalshi, polymarket, robinhood, or coinbase
        market_id:
          type: string
          title: Market Id
          description: Platform-specific identifier (ticker or numeric ID)
        title:
          type: string
          title: Title
          description: Market question / title
        url:
          type: string
          title: Url
          description: Public URL on the source platform
          default: ''
        category:
          type: string
          title: Category
          description: Market category if known
          default: ''
        also_on:
          additionalProperties:
            type: string
          type: object
          title: Also On
          description: Cross-platform URLs for the same market (e.g. coinbase, robinhood)
        yes_price:
          type: number
          maximum: 1
          minimum: 0
          title: Yes Price
          description: Current YES price (probability)
        volume_24h:
          type: number
          minimum: 0
          title: Volume 24H
          description: 24h trading volume in USD
          default: 0
        liquidity:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
          title: Liquidity
          description: Current liquidity in USD
        open_interest:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
          title: Open Interest
          description: Open interest in USD
        resolution_date:
          anyOf:
            - type: string
            - type: 'null'
          title: Resolution Date
          description: Expected resolution date (ISO 8601)
        event_slug:
          anyOf:
            - type: string
            - type: 'null'
          title: Event Slug
          description: Parent event identifier (groups related markets)
        event_title:
          anyOf:
            - type: string
            - type: 'null'
          title: Event Title
          description: >-
            Parent event title (e.g., 'Who will leave the Trump
            administration?')
        updated_at:
          type: string
          format: date-time
          title: Updated At
          description: When this data was last refreshed
      type: object
      required:
        - platform
        - market_id
        - title
        - yes_price
        - updated_at
      title: Market
      description: Prediction market with live pricing data.
      example:
        also_on:
          coinbase: https://www.coinbase.com/predictions/event/KXFED-26MAR19
        category: economics
        liquidity: 85000
        market_id: KXFED-26MAR19
        open_interest: 312000
        platform: kalshi
        resolution_date: '2026-03-19T20:00:00Z'
        title: Will the Fed cut rates at the March 2026 meeting?
        updated_at: '2026-03-21T14:30:00Z'
        url: https://kalshi.com/markets/kxfed/kxfed-26mar19
        volume_24h: 142350
        yes_price: 0.62
    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

````