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

# Get markets

> Retrieve all markets with optional filtering



## OpenAPI

````yaml api-reference/oapi-schemas/market-schema.json get /v1/markets
openapi: 3.0.1
info:
  title: Market API
  description: Market data and information endpoints
  version: v1.0.0
servers:
  - url: https://api.polymarket.us
security: []
tags:
  - name: Markets
paths:
  /v1/markets:
    get:
      tags:
        - Markets
      summary: Get markets
      description: Retrieve all markets with optional filtering
      operationId: MarketService_GetMarkets
      parameters:
        - name: limit
          in: query
          description: Page size
          required: false
          schema:
            type: integer
            format: int32
        - name: offset
          in: query
          description: Page offset
          required: false
          schema:
            type: integer
            format: int32
        - name: orderBy
          in: query
          description: Order by fields
          required: false
          schema:
            type: array
            items:
              type: string
        - name: orderDirection
          in: query
          description: Order direction (asc or desc)
          required: false
          schema:
            type: string
        - name: id
          in: query
          description: Filter by market IDs
          required: false
          schema:
            type: array
            items:
              type: integer
              format: int32
        - name: slug
          in: query
          description: Filter by market slugs
          required: false
          schema:
            type: array
            items:
              type: string
        - name: archived
          in: query
          description: Filter by archived status
          required: false
          schema:
            type: boolean
        - name: active
          in: query
          description: Filter by active status
          required: false
          schema:
            type: boolean
        - name: closed
          in: query
          description: Filter by closed status
          required: false
          schema:
            type: boolean
        - name: liquidityNumMin
          in: query
          description: Minimum liquidity
          required: false
          schema:
            type: number
            format: double
        - name: liquidityNumMax
          in: query
          description: Maximum liquidity
          required: false
          schema:
            type: number
            format: double
        - name: volumeNumMin
          in: query
          description: Minimum volume
          required: false
          schema:
            type: number
            format: double
        - name: volumeNumMax
          in: query
          description: Maximum volume
          required: false
          schema:
            type: number
            format: double
        - name: startDateMin
          in: query
          description: Minimum start date
          required: false
          schema:
            type: string
        - name: startDateMax
          in: query
          description: Maximum start date
          required: false
          schema:
            type: string
        - name: endDateMin
          in: query
          description: Minimum end date
          required: false
          schema:
            type: string
        - name: endDateMax
          in: query
          description: Maximum end date
          required: false
          schema:
            type: string
        - name: tagId
          in: query
          description: Filter by tag ID
          required: false
          schema:
            type: integer
            format: int32
        - name: relatedTags
          in: query
          description: Include related tags in results
          required: false
          schema:
            type: boolean
        - name: cyom
          in: query
          description: Filter by Create Your Own Market status
          required: false
          schema:
            type: boolean
        - name: gameId
          in: query
          description: Filter by game ID
          required: false
          schema:
            type: string
        - name: sportsMarketTypes
          in: query
          description: Filter by sports market types
          required: false
          schema:
            type: array
            items:
              type: string
              enum:
                - UNSPECIFIED
                - MONEYLINE
                - SPREAD
                - TOTAL
                - PROP
        - name: rewardsMinSize
          in: query
          description: Minimum rewards size filter
          required: false
          schema:
            type: number
            format: double
        - name: questionIds
          in: query
          description: Filter by question IDs
          required: false
          schema:
            type: array
            items:
              type: string
        - name: includeTag
          in: query
          description: Include tag information in response
          required: false
          schema:
            type: boolean
        - name: categories
          in: query
          description: Filter by categories
          required: false
          schema:
            type: array
            items:
              type: string
        - name: marketTypes
          in: query
          description: Filter by market types
          required: false
          schema:
            type: array
            items:
              type: string
      responses:
        '200':
          description: List of markets
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMarketsResponse'
        '500':
          description: Internal server error
components:
  schemas:
    GetMarketsResponse:
      type: object
      properties:
        markets:
          type: array
          items:
            $ref: '#/components/schemas/Market'
          description: List of markets
    Market:
      type: object
      description: Market information and configuration
      properties:
        id:
          type: string
          description: Unique market identifier
        question:
          type: string
          description: Market question
        slug:
          type: string
          description: Market slug for URL
        description:
          type: string
          description: Market description
        startDate:
          type: string
          format: date-time
          description: Market start date in ISO 8601 format
        endDate:
          type: string
          format: date-time
          description: Market end date in ISO 8601 format
        category:
          type: string
          description: Market category
        marketType:
          type: string
          description: Type of market
        active:
          type: boolean
          description: Whether market is active
        closed:
          type: boolean
          description: Whether market is closed
        archived:
          type: boolean
          description: Whether market is archived
        hidden:
          type: boolean
          description: Whether market is hidden
        updatedAt:
          type: string
          format: date-time
          description: Last update timestamp in ISO 8601 format
        gameStartTime:
          type: string
          format: date-time
          description: Game start time in ISO 8601 format
        manualActivation:
          type: boolean
          description: Whether manual activation is required
        sportsMarketType:
          type: string
          description: Sports market type (e.g., moneyline, spread, total)
        sportsMarketTypeV2:
          type: string
          enum:
            - SPORTS_MARKET_TYPE_UNSPECIFIED
            - SPORTS_MARKET_TYPE_MONEYLINE
            - SPORTS_MARKET_TYPE_SPREAD
            - SPORTS_MARKET_TYPE_TOTAL
            - SPORTS_MARKET_TYPE_PROP
          description: Sports market type v2 enum
        line:
          type: number
          format: decimal
          description: Line value for spread/total markets
        outcomes:
          type: string
          description: JSON string of outcome labels
        outcomePrices:
          type: string
          description: JSON string of outcome prices
        ep3Status:
          type: string
          description: EP3 status (e.g., OPEN, CLOSED)
        marketSides:
          type: array
          items:
            $ref: '#/components/schemas/MarketSide'
          description: Market sides representing different outcomes
        events:
          type: array
          items:
            $ref: '#/components/schemas/Event'
          description: Associated events
    MarketSide:
      type: object
      description: Market side representing an outcome
      properties:
        id:
          type: string
          description: Market side ID
        marketSideType:
          type: string
          description: Market side type (e.g., MARKET_SIDE_TYPE_INSTRUMENT)
        identifier:
          type: string
          description: Market side identifier
        createdAt:
          type: string
          format: date-time
          description: Creation timestamp in ISO 8601 format
        updatedAt:
          type: string
          format: date-time
          description: Update timestamp in ISO 8601 format
        description:
          type: string
          description: Market side description (e.g., team name)
        marketId:
          type: integer
          description: Associated market ID
        long:
          type: boolean
          description: Whether this is the long side
        teamId:
          type: integer
          description: Team ID if applicable
        team:
          $ref: '#/components/schemas/Team'
        participantId:
          type: string
          description: Participant ID reference
    Event:
      type: object
      description: Event information and configuration
      properties:
        id:
          type: string
          description: Unique event identifier
        ticker:
          type: string
          description: Event ticker symbol
        slug:
          type: string
          description: Event slug for URL
        title:
          type: string
          description: Event title
        description:
          type: string
          description: Event description
        startDate:
          type: string
          format: date-time
          description: Event start date in ISO 8601 format
        endDate:
          type: string
          format: date-time
          description: Event end date in ISO 8601 format
        active:
          type: boolean
          description: Whether event is active
        closed:
          type: boolean
          description: Whether event is closed
        archived:
          type: boolean
          description: Whether event is archived
        hidden:
          type: boolean
          description: Whether event is hidden
        category:
          type: string
          description: Event category
        createdAt:
          type: string
          format: date-time
          description: Creation timestamp in ISO 8601 format
        updatedAt:
          type: string
          format: date-time
          description: Last update timestamp in ISO 8601 format
        startTime:
          type: string
          format: date-time
          description: Event start time in ISO 8601 format
        seriesSlug:
          type: string
          description: Series slug
        period:
          type: string
          description: Event period (e.g., NS for not started)
        gameId:
          type: integer
          description: Game ID from sports provider
        sportradarGameId:
          type: string
          description: Sportradar game ID
        participants:
          type: array
          items:
            $ref: '#/components/schemas/Participant'
          description: Event participants
        markets:
          type: array
          items:
            $ref: '#/components/schemas/Market'
          description: Associated markets
    Team:
      type: object
      description: Team information
      properties:
        id:
          type: integer
          description: Team ID
        name:
          type: string
          description: Team name
        abbreviation:
          type: string
          description: Team abbreviation
        league:
          type: string
          description: League name
        record:
          type: string
          description: Team record
        logo:
          type: string
          description: Logo URL
        alias:
          type: string
          description: Team alias
        safeName:
          type: string
          description: Safe name
        homeIcon:
          type: string
          description: Home icon URL
        awayIcon:
          type: string
          description: Away icon URL
        colorPrimary:
          type: string
          description: Primary team color
        providerId:
          type: integer
          description: Provider ID
        ordering:
          type: string
          description: Ordering value (e.g., away, home)
        longIcon:
          type: string
          description: Long icon URL
        shortIcon:
          type: string
          description: Short icon URL
        displayAbbreviation:
          type: string
          description: Display abbreviation
        providerIds:
          type: array
          items:
            $ref: '#/components/schemas/ProviderIdMapping'
          description: Provider ID mappings
    Participant:
      type: object
      description: Event participant (team, player, or nominee)
      properties:
        id:
          type: string
          description: Participant ID
        type:
          type: string
          enum:
            - PARTICIPANT_TYPE_UNSPECIFIED
            - PARTICIPANT_TYPE_NOMINEE
            - PARTICIPANT_TYPE_PLAYER
            - PARTICIPANT_TYPE_TEAM
          description: Participant type
        team:
          $ref: '#/components/schemas/Team'
    ProviderIdMapping:
      type: object
      description: Provider ID mapping
      properties:
        provider:
          type: string
          description: Provider name (e.g., PROVIDER_SPORTSDATAIO, PROVIDER_SPORTRADAR)
        providerId:
          type: string
          description: Provider-specific ID

````