> ## 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 market by slug

> Retrieve a specific market by its slug



## OpenAPI

````yaml api-reference/oapi-schemas/market-schema.json get /v1/market/slug/{slug}
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/market/slug/{slug}:
    get:
      tags:
        - Markets
      summary: Get market by slug
      description: Retrieve a specific market by its slug
      operationId: MarketService_GetMarketBySlug
      parameters:
        - name: slug
          in: path
          description: Market slug
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Market details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMarketBySlugResponse'
        '404':
          description: Market not found
        '500':
          description: Internal server error
components:
  schemas:
    GetMarketBySlugResponse:
      type: object
      properties:
        market:
          $ref: '#/components/schemas/Market'
    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

````