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

> Returns all available markets per sport. Use `shape` to parse a market's odds and `prematch`/`live` to see where it's offered. No API key required.



## OpenAPI

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


    - 265+ 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:
  /markets:
    get:
      tags:
        - Markets
      summary: Get Markets
      description: >-
        Returns all available markets per sport. Use `shape` to parse a market's
        odds and `prematch`/`live` to see where it's offered. No API key
        required.
      parameters:
        - example: '"football"'
          description: >-
            Sport slug (e.g. football, basketball). Omit for all sports keyed by
            slug.
          name: sport
          in: query
          schema:
            type: string
      responses:
        '200':
          description: >-
            With `sport`: markets for that sport. Without: all sports keyed by
            slug.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.MarketsResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.ErrorResponse'
        '404':
          description: Unknown sport slug
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.ErrorResponse'
        '503':
          description: Catalogue warming up; retry shortly
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.ErrorResponse'
components:
  schemas:
    controllers.MarketsResponse:
      type: object
      properties:
        sport:
          type: object
          properties:
            name:
              type: string
              example: Football
            slug:
              type: string
              example: football
        markets:
          type: array
          items:
            $ref: '#/components/schemas/controllers.MarketInfo'
    controllers.ErrorResponse:
      type: object
      properties:
        error:
          type: string
          example: Error message
    controllers.MarketInfo:
      type: object
      properties:
        name:
          type: string
          example: Spread
          description: Market name, as it appears in /odds responses.
        shape:
          type: string
          enum:
            - moneyline
            - line
            - outcomes
            - yesno
            - labelled
          example: line
          description: >-
            How to parse the odds. `moneyline`: home/away (+draw on 3-way
            markets). `line`: one entry per line, with hdp and over/under or
            home/away. `outcomes`: fixed outcomes (1X/12/X2, odd/even). `yesno`:
            yes/no prices. `labelled`: one price per label ("2-1", "1st Half", a
            player name).
        period:
          type: string
          enum:
            - match
            - first-half
            - second-half
            - quarter
            - set
            - game
            - inning
          example: match
          description: Which part of the event the market covers.
        prematch:
          type: boolean
          example: true
          description: Offered pre-match.
        live:
          type: boolean
          example: true
          description: Offered in-play.

````