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

# Screen Markets

> Batch screen markets with lightweight scoring (no LLM pipeline).



## OpenAPI

````yaml POST /v1/screen
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/screen:
    post:
      tags:
        - Markets
      summary: Batch screen markets
      description: Batch screen markets with lightweight scoring (no LLM pipeline).
      operationId: /v1/screen
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ScreenRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/ScreenResult'
                type: array
                title: Response /V1/Screen
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ScreenRequest:
      properties:
        market_ids:
          items:
            type: string
          type: array
          title: Market Ids
          description: Specific market IDs to screen (if empty, lists markets with filters)
        platform:
          type: string
          title: Platform
          description: 'Filter by platform: ''kalshi'', ''polymarket'', or ''robinhood'''
          default: ''
        min_volume_24h:
          type: number
          minimum: 0
          title: Min Volume 24H
          description: Minimum 24h volume in USD
          default: 0
        min_score:
          type: number
          maximum: 1
          minimum: 0
          title: Min Score
          description: Minimum quick_score filter
          default: 0
        limit:
          type: integer
          maximum: 200
          minimum: 1
          title: Limit
          description: Maximum results
          default: 50
      type: object
      title: ScreenRequest
      description: Request body for the batch market screening endpoint.
      example:
        limit: 20
        min_score: 0.5
        min_volume_24h: 50000
        platform: kalshi
    ScreenResult:
      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 / title
        yes_price:
          type: number
          maximum: 1
          minimum: 0
          title: Yes Price
          description: Current YES price
        volume_24h:
          type: number
          minimum: 0
          title: Volume 24H
          description: 24h trading volume in USD
        score:
          type: number
          maximum: 2
          minimum: 0
          title: Score
          description: Composite score (higher = more interesting)
        category:
          type: string
          title: Category
          description: Category guess
          default: ''
        trend:
          type: string
          enum:
            - rising
            - falling
            - stable
          title: Trend
          description: Price trend from recent ticks
        volume_spike:
          type: boolean
          title: Volume Spike
          description: Whether volume is >2x the 7-day average
        hours_to_resolution:
          anyOf:
            - type: number
            - type: 'null'
          title: Hours To Resolution
          description: Hours until market resolution
        bid_ask_spread:
          anyOf:
            - type: number
            - type: 'null'
          title: Bid Ask Spread
          description: Current bid-ask spread in cents
        price_velocity_1h:
          anyOf:
            - type: number
            - type: 'null'
          title: Price Velocity 1H
          description: Price change per hour over last hour
        cached_edge:
          anyOf:
            - type: number
            - type: 'null'
          title: Cached Edge
          description: Edge from a prior analysis
        cached_confidence:
          anyOf:
            - type: number
            - type: 'null'
          title: Cached Confidence
          description: Confidence from a prior analysis
        cached_recommendation:
          anyOf:
            - type: string
            - type: 'null'
          title: Cached Recommendation
          description: Recommendation from a prior analysis
        action:
          type: string
          enum:
            - analyze
            - watch
            - skip
          title: Action
          description: Suggested next step
      type: object
      required:
        - platform
        - market_id
        - title
        - yes_price
        - volume_24h
        - score
        - trend
        - volume_spike
        - action
      title: ScreenResult
      description: Lightweight screening signal for a single market (no LLM required).
      example:
        action: analyze
        cached_confidence: 0.82
        cached_edge: 0.09
        cached_recommendation: BUY_YES
        category: economics
        market_id: KXFED-26MAR19
        platform: kalshi
        score: 1.45
        title: Will the Fed cut rates at the March 2026 meeting?
        trend: rising
        volume_24h: 142350
        volume_spike: true
        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

````