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

# Execution Guidance

> Optimal trade execution analysis from bid/ask spread patterns.



## OpenAPI

````yaml GET /v1/markets/{platform}/{market_id}/execution
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}/execution:
    get:
      tags:
        - Markets
      summary: Get trade execution guidance
      description: Optimal trade execution analysis from bid/ask spread patterns.
      operationId: /v1/markets/{platform}/{market_id}/execution
      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
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExecutionGuidance'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ExecutionGuidance:
      properties:
        market_id:
          type: string
          title: Market Id
          description: Market identifier
        platform:
          type: string
          title: Platform
          description: kalshi, polymarket, robinhood, or coinbase
        title:
          type: string
          title: Title
          description: Market title
          default: ''
        current_bid:
          anyOf:
            - type: number
              maximum: 1
              minimum: 0
            - type: 'null'
          title: Current Bid
          description: Current best YES bid
        current_ask:
          anyOf:
            - type: number
              maximum: 1
              minimum: 0
            - type: 'null'
          title: Current Ask
          description: Current best YES ask
        current_spread:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
          title: Current Spread
          description: Current bid-ask spread
        avg_spread_48h:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
          title: Avg Spread 48H
          description: Average spread over last 48h
        spread_percentile:
          anyOf:
            - type: number
              maximum: 100
              minimum: 0
            - type: 'null'
          title: Spread Percentile
          description: >-
            Current spread percentile vs 48h history (lower = tighter than
            usual)
        spread_trend:
          type: string
          title: Spread Trend
          description: 'Spread direction: ''tightening'', ''widening'', or ''stable'''
          default: stable
        liquidity_score:
          type: integer
          maximum: 100
          minimum: 0
          title: Liquidity Score
          description: Liquidity quality 0-100 based on spread + volume
          default: 50
        estimated_slippage_pct:
          type: number
          minimum: 0
          title: Estimated Slippage Pct
          description: Estimated slippage as percentage of price
          default: 0
        recommendation:
          type: string
          title: Recommendation
          description: LIMIT_ORDER, MARKET_ORDER, or WAIT
          default: MARKET_ORDER
        suggested_limit_price:
          anyOf:
            - type: number
              maximum: 1
              minimum: 0
            - type: 'null'
          title: Suggested Limit Price
          description: Suggested limit price (midpoint adjusted for spread direction)
        rationale:
          type: string
          title: Rationale
          description: Explanation of the recommendation
          default: ''
        upcoming_event:
          anyOf:
            - type: string
            - type: 'null'
          title: Upcoming Event
          description: Nearby event that may affect spreads
        hours_to_event:
          anyOf:
            - type: number
              minimum: 0
            - type: 'null'
          title: Hours To Event
          description: Hours until the next relevant event
        tick_count:
          type: integer
          minimum: 0
          title: Tick Count
          description: Number of ticks analyzed
          default: 0
        generated_at:
          type: string
          format: date-time
          title: Generated At
          description: When this guidance was generated
      type: object
      required:
        - market_id
        - platform
      title: ExecutionGuidance
      description: Optimal trade execution analysis from tick data.
      example:
        avg_spread_48h: 0.03
        current_ask: 0.64
        current_bid: 0.6
        current_spread: 0.04
        estimated_slippage_pct: 0.8
        generated_at: '2026-03-21T14:30:00Z'
        hours_to_event: 18.5
        liquidity_score: 68
        market_id: KXFED-26MAR19
        platform: kalshi
        rationale: >-
          Spread is wider than usual (72nd percentile). Use a limit order at
          0.61 to capture midpoint. Avoid market orders — slippage ~0.8% at
          current depth.
        recommendation: LIMIT_ORDER
        spread_percentile: 72
        spread_trend: widening
        suggested_limit_price: 0.61
        tick_count: 96
        title: Will the Fed cut rates at the March 2026 meeting?
        upcoming_event: FOMC Statement
    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

````