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

# Get Market by Slug

> Get Market by Slug.

Returns one market selected by its slug.

**Base URL:** `https://api.dexbuilder.com`

**Authentication:** This is a public market-data endpoint and does not require authentication.

## Request

```bash theme={null}
curl -G "https://api.dexbuilder.com/api/v4/prediction/markets/slug/{slug}"
```

`slug` is the URL-safe market identifier.

The OpenAPI panel below is the source of truth for required parameters, types, enum values, and request-body fields. Timestamps are Unix timestamps unless the field description states otherwise.

## Response

Returns the market definition, including condition ID, event ID, outcomes, token IDs, prices, status, resolution data, and trading constraints.

A successful response uses HTTP 200. Invalid parameters or request bodies return HTTP 400. Private endpoints can return HTTP 401 when authentication fails, and temporary upstream failures can return HTTP 503. The error response contains a machine-readable label and message.

For order, position, claim, transfer, and account operations, treat the response as the current server result and query the resource again when the operation is asynchronous.


## OpenAPI

````yaml openapi/event-markets-en.yaml GET /api/v4/prediction/markets/slug/{slug}
openapi: 3.0.3
info:
  title: DexBuilder Prediction Markets API
  version: 1.0.0
  description: DexBuilder Prediction Markets REST API.
servers:
  - url: https://api.dexbuilder.com
security: []
paths:
  /api/v4/prediction/markets/slug/{slug}:
    get:
      summary: Get Market by Slug
      description: Get Market by Slug.
      operationId: query_market_by_slug
      parameters:
        - name: slug
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Request succeeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MarketDetail'
        '400':
          description: Invalid request or parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: Service temporarily unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    MarketDetail:
      type: object
      properties:
        accepting_orders:
          type: boolean
          nullable: true
        best_ask:
          type: string
        best_bid:
          type: string
        category:
          type: string
          nullable: true
        closed:
          type: boolean
        condition_id:
          type: string
        description:
          type: object
          nullable: true
        enable_order_book:
          type: boolean
          nullable: true
        end_date:
          type: integer
          nullable: true
        event_id:
          type: string
        icon:
          type: string
          nullable: true
        image:
          type: string
          nullable: true
        last_trade_price:
          type: string
        limit_buy_min_shares:
          type: string
        market_id:
          type: string
        min_order_size:
          type: string
          nullable: true
        neg_risk:
          type: boolean
          nullable: true
        outcomes:
          type: array
          items:
            $ref: '#/components/schemas/OutcomeRef'
        question:
          type: object
          nullable: true
        resolution_source:
          type: string
          nullable: true
        resolved_at:
          type: integer
          nullable: true
        slug:
          type: string
        start_date:
          type: integer
          nullable: true
        status:
          type: string
        tags:
          type: array
          items:
            $ref: '#/components/schemas/TagSummary'
        tick_size:
          type: string
          nullable: true
        uma_end_date:
          type: string
          nullable: true
        uma_end_date_iso:
          type: string
          nullable: true
        uma_resolution_status:
          type: string
          nullable: true
        uma_resolution_statuses:
          type: string
          nullable: true
        volume:
          type: string
          nullable: true
        volume_24hr:
          type: string
        winning_outcome:
          type: string
          nullable: true
        winning_token_id:
          type: string
          nullable: true
      description: Response object.
    Error:
      type: object
      description: Error response.
      properties:
        label:
          type: string
          example: INVALID_ARGUMENT
        message:
          type: string
          example: invalid request
    OutcomeRef:
      type: object
      properties:
        outcome:
          type: object
          nullable: true
        token_id:
          type: string
      description: Response object.
    TagSummary:
      type: object
      properties:
        label:
          type: object
          nullable: true
        slug:
          type: string
        tag_id:
          type: string
      description: Response object.

````

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