Odds-API.io Value Bets API

openapi: 3.2.0
info:
  description: 'Odds-API.io is a powerful sports betting odds comparison API, providing real-time data from 450+ bookmakers across 34 sports with near zero latency.


    - 450+ 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) Value…
  contact: {}
  version: 3.0.0
servers:
- url: https://api.odds-api.io/v3
tags:
- name: Value Bets
paths:
  /value-bets:
    get:
      security:
      - ApiKeyAuth: []
      description: Returns value bets for a specific bookmaker with optional match info. Updated every 5 seconds.
      tags:
      - Value Bets
      summary: Get Value Bets
      parameters:
      - description: API key for authentication
        name: apiKey
        in: query
        required: true
        schema:
          type: string
      - example: '"Bet365"'
        description: Bookmaker name (e.g. Bet365)
        name: bookmaker
        in: query
        required: true
        schema:
          type: string
      - example: baseball
        description: Filter by sport name or slug (e.g. Baseball or baseball). Optional.
        name: sport
        in: query
        schema:
          type: string
      - example: usa-mlb
        description: Filter by league slug (e.g. usa-mlb). Requires sport to also be set.
        name: league
        in: query
        schema:
          type: string
      - example: true
        description: Include event details
        name: includeEventDetails
        in: query
        schema:
          type: boolean
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/dto.EventValueBet'
        '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'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.ErrorResponse'
      x-mint:
        metadata:
          description: 'Get value bets for one bookmaker: prices above a fair-odds estimate with expected value per outcome, filtered by sport or league, updated every 5 seconds.'
      operationId: getValueBets
      x-operation-id-source: derived
components:
  schemas:
    dto.EventValueBet:
      type: object
      properties:
        betSide:
          type: string
        bookmaker:
          type: string
        bookmakerOdds:
          $ref: '#/components/schemas/dto.BookmakerOdds'
        event:
          $ref: '#/components/schemas/dto.EventInfo'
        eventId:
          type: integer
        expectedValue:
          type: number
          description: Bookmaker odds / fair odds x 100. 100 is the fair price; 103.42 means a 3.42% edge (edge in percent = expectedValue - 100). Values below 100 are a negative edge.
          example: 103.42
        expectedValueUpdatedAt:
          type: string
          description: Last time the expected value or the sharp limit increased. Not a freshness signal.
        firstSeenAt:
          type: string
          format: date-time
          description: When this value bet first appeared.
        bookmakerOddsUpdatedAt:
          type: string
          format: date-time
          description: Last time this bookmaker price was written. May be absent.
        id:
          type: string
        market:
          $ref: '#/components/schemas/dto.MarketResult'
    dto.BookmakerOdds:
      type: object
      properties:
        away:
          type: string
        awayDirectLink:
          type: string
        draw:
          type: string
        drawDirectLink:
          type: string
        hdp:
          type: string
        home:
          type: string
        homeDirectLink:
          type: string
        href:
          type: string
    dto.EventInfo:
      type: object
      properties:
        away:
          type: string
        date:
          type: string
        home:
          type: string
        league:
          type: string
        sport:
          type: string
    controllers.ErrorResponse:
      type: object
      properties:
        error:
          type: string
          example: Error message
    dto.MarketResult:
      type: object
      properties:
        away:
          type: string
        draw:
          type: string
        hdp:
          type: number
        home:
          type: string
        max:
          type: number
        name:
          type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: query
      name: apiKey
      description: Your Odds-API.io API key, sent as the apiKey query parameter. Get one at https://odds-api.io/pricing.
x-origin:
- url: https://api.odds-api.io/v3/docs/doc.json
  format: swagger
  version: '2.0'
  converter:
    url: https://github.com/mermade/oas-kit
    version: 7.0.8