> ## Documentation Index
> Fetch the complete documentation index at: https://docs.odds-api.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Odds Summary

> Best, average, median, worst and margin-free fair price per market line across bookmakers, for odds comparison pages. A bookmaker counts only while its prices are updating (a change within 5 minutes before kickoff, 60 seconds live). Exchanges are reported separately. Available on Growth plans and above. Free, Solo and Starter plans receive a sample response with demo set to true and an X-OddsAPI-Demo: true header.



## OpenAPI

````yaml /api-reference/openapi.json get /odds/summary
openapi: 3.0.0
info:
  description: >-
    Odds-API.io is a powerful sports betting odds comparison API, providing
    real-time data from 365+ bookmakers across 34 sports with near zero latency.


    - 365+ bookmakers supported

    - 34 sports including Football, Basketball, Tennis, Esports and more

    - Real-time odds with close to zero latency

    - Pre-match & In-play odds coverage

    - 99.9% uptime for reliability
  title: Odds-API.io - Real-Time Sports Betting Odds API (v3)
  contact: {}
  version: 3.0.0
servers:
  - url: https://api.odds-api.io/v3
security: []
paths:
  /odds/summary:
    get:
      tags:
        - Odds
      summary: Get Odds Summary
      description: >-
        Best, average, median, worst and margin-free fair price per market line
        across bookmakers, for odds comparison pages. A bookmaker counts only
        while its prices are updating (a change within 5 minutes before kickoff,
        60 seconds live). Exchanges are reported separately. Available on Growth
        plans and above. Free, Solo and Starter plans receive a sample response
        with demo set to true and an X-OddsAPI-Demo: true header.
      parameters:
        - description: API key for authentication
          name: apiKey
          in: query
          required: true
          schema:
            type: string
        - example: '"123456"'
          description: Event ID
          name: eventId
          in: query
          required: true
          schema:
            type: string
        - description: >-
            Comma-separated market names, case-insensitive (default
            ML,Spread,Totals, max 20)
          name: markets
          in: query
          schema:
            type: string
        - description: >-
            main (default) returns each ladder market's main line; all returns
            every line priced by at least 3 bookmakers
          name: lines
          in: query
          schema:
            type: string
        - description: >-
            Restrict the summary to these bookmakers. Each must be in your
            selected bookmakers
          name: bookmakers
          in: query
          schema:
            type: string
        - description: >-
            Add the best exchange back price per outcome in a separate exchanges
            block
          name: includeExchanges
          in: query
          schema:
            type: boolean
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.EventSummary'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.ErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.ErrorResponse'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.ErrorResponse'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    controllers.EventSummary:
      type: object
      properties:
        away:
          type: string
        computedAt:
          type: string
        date:
          type: string
        demo:
          type: boolean
        eventId:
          type: string
        home:
          type: string
        markets:
          type: array
          items:
            $ref: '#/components/schemas/controllers.SummaryMarket'
        message:
          type: string
        status:
          type: string
    controllers.ErrorResponse:
      type: object
      properties:
        error:
          type: string
          example: Error message
    controllers.SummaryMarket:
      type: object
      properties:
        lines:
          type: array
          items:
            $ref: '#/components/schemas/controllers.SummaryLine'
        name:
          type: string
    controllers.SummaryLine:
      type: object
      properties:
        books:
          type: integer
        exchanges:
          $ref: '#/components/schemas/controllers.SummaryExchanges'
        fairBooks:
          type: integer
        hdp:
          type: number
          nullable: true
        main:
          type: boolean
        outcomes:
          $ref: '#/components/schemas/controllers.SummaryOutcomes'
        payout:
          $ref: '#/components/schemas/controllers.SummaryPayout'
    controllers.SummaryExchanges:
      type: object
      additionalProperties:
        $ref: '#/components/schemas/controllers.SummaryExchangeQuote'
    controllers.SummaryOutcomes:
      type: object
      additionalProperties:
        $ref: '#/components/schemas/controllers.SummaryOutcome'
    controllers.SummaryPayout:
      type: object
      properties:
        average:
          type: number
        best:
          type: number
    controllers.SummaryExchangeQuote:
      type: object
      properties:
        best:
          type: number
        currency:
          type: string
        liquidity:
          type: number
        venue:
          type: string
    controllers.SummaryOutcome:
      type: object
      properties:
        average:
          type: number
        best:
          type: number
        bestBookmakers:
          type: array
          items:
            type: string
        excluded:
          type: integer
        fair:
          type: number
        median:
          type: number
        sharpFair:
          type: number
        worst:
          type: number

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.