> ## Documentation Index
> Fetch the complete documentation index at: https://api.synthesis.trade/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Polymarket Market by Slug

> Get a Polymarket event by slug with nested markets.



## OpenAPI

````yaml /openapi.json get /api/v1/polymarket/market/slug/{slug}
openapi: 3.1.0
info:
  title: Synthesis API
  version: 1.0.0
  description: Unified prediction market API for Polymarket and Kalshi.
servers:
  - url: https://synthesis.trade
security: []
tags:
  - name: Projects
    description: Create and manage project accounts, sessions, and account API keys.
  - name: Accounts
    description: >-
      Authenticate and manage account-level sessions, account API keys, and
      public account preferences.
  - name: Markets
    description: Unified market discovery and analytics across Polymarket and Kalshi.
  - name: Polymarket
    description: Polymarket market data, prices, orderbooks, trades, and holders endpoints.
  - name: Kalshi
    description: Kalshi market data, events, history, leaderboard, and profile endpoints.
  - name: Wallets
    description: Wallet management routes. Each wallet supports multiple chains.
  - name: Polygon
    description: >-
      Polygon wallet routes for balances, orders, minting, redemption,
      withdrawals, and swaps.
  - name: Polygon Copytrades
    description: Polymarket copytrade configuration and management for Polygon wallets.
  - name: Solana
    description: >-
      Solana wallet routes used for Kalshi balances, KYC, orders, redemption,
      and withdrawals.
  - name: News
    description: News endpoints with market and event matching.
  - name: WebSockets
    description: >-
      Real-time streaming endpoints for orderbooks, trades, balances, and live
      data feeds.
paths:
  /api/v1/polymarket/market/slug/{slug}:
    get:
      tags:
        - Polymarket
      summary: Get Polymarket Market by Slug
      description: Get a Polymarket event by slug with nested markets.
      operationId: get-polymarket-market-slug
      parameters:
        - name: slug
          in: path
          required: true
          description: Event or market slug.
          schema:
            type: string
            example: will-bitcoin-reach-100k
        - name: sort
          in: query
          required: false
          description: >-
            Sort field for markets. Supported values: `outcomes`, `left_price`,
            `right_price`, `liquidity`, `volume`, `volume24hr`, `volume1wk`,
            `volume1mo`, `volume1yr`, `created_at`, `ends_at`.
          schema:
            type: string
            default: left_price
        - name: order
          in: query
          required: false
          description: 'Sort direction. Supported values: `ASC` or `DESC`.'
          schema:
            type: string
            default: DESC
      responses:
        '200':
          description: Polymarket market by slug
          content:
            application/json:
              example:
                success: true
                response:
                  event:
                    event_id: 12345
                    title: Will Bitcoin reach $100k by end of 2025?
                    slug: will-bitcoin-reach-100k-by-end-of-2025
                    description: >-
                      This market resolves to Yes if spot Bitcoin trades at or
                      above $100,000 before 2025 ends.
                    image: https://example.com/bitcoin.png
                    tags:
                      - crypto
                      - bitcoin
                    labels:
                      - crypto
                      - macro
                    neg_risk: false
                    active: true
                    liquidity: '1500000'
                    volume: '5000000'
                    volume24hr: '250000'
                    volume1wk: '900000'
                    volume1mo: '2200000'
                    volume1yr: '5000000'
                    live:
                      live: false
                      ended: false
                    created_at: '2026-01-01T00:00:00'
                    updated_at: '2026-01-01T00:00:00'
                    ends_at: '2026-12-31T23:59:59'
                  markets:
                    - event_id: 12345
                      condition_id: >-
                        0xbd71b43bb47eb60dbcb41fa25df2a0ed4da612873d6e0447a2c730bd4cc25910
                      question: Will Bitcoin reach $100k?
                      outcome: 'Yes'
                      slug: will-bitcoin-reach-100k-yes
                      description: >-
                        Buy Yes if you think Bitcoin will trade at or above
                        $100,000 before market expiry.
                      image: https://example.com/bitcoin-market.png
                      left_outcome: 'Yes'
                      right_outcome: 'No'
                      left_price: '0.65'
                      right_price: '0.35'
                      left_token_id: >-
                        21742633143463906290569050155826241533067272736897614950488156847949938836455
                      right_token_id: >-
                        48572956138472615938471625938471659384716593847165938471659384716593847165938
                      winner_token_id: ''
                      active: true
                      resolved: false
                      fees: true
                      decimals: 6
                      liquidity: '1500000'
                      volume: '5000000'
                      volume24hr: '250000'
                      volume1wk: '900000'
                      volume1mo: '2200000'
                      volume1yr: '5000000'
                      rewards:
                        rewards: false
                      created_at: '2026-01-01T00:00:00'
                      updated_at: '2026-01-01T00:00:00'
                      ends_at: '2026-12-31T23:59:59'
      security: []

````