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

> Get markets across venues with filters for venue, price, dates, labels, and sorting.



## OpenAPI

````yaml /openapi.json get /api/v1/markets
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/markets:
    get:
      tags:
        - Markets
      summary: Get Markets
      description: >-
        Get markets across venues with filters for venue, price, dates, labels,
        and sorting.
      operationId: get-markets
      parameters:
        - name: venue
          in: query
          required: false
          description: 'Filter by venue. Supported values: `polymarket` or `kalshi`.'
          schema:
            type: string
            example: polymarket
        - name: sort
          in: query
          required: false
          description: >-
            Sort field. Supported values: `liquidity`, `volume`, `created_at`,
            `ends_at`, or `newest` (alias for `created_at`).
          schema:
            type: string
            default: volume
            example: ends_at
        - name: order
          in: query
          required: false
          description: 'Sort direction. Supported values: `ASC` or `DESC`.'
          schema:
            type: string
            default: DESC
            example: ASC
        - name: limit
          in: query
          required: false
          description: Maximum events to return. Capped at `250`.
          schema:
            type: integer
            default: 100
            example: 50
        - name: offset
          in: query
          required: false
          description: Pagination offset.
          schema:
            type: integer
            default: 0
            example: 0
        - name: min_price
          in: query
          required: false
          description: Minimum market price.
          schema:
            type: number
        - name: max_price
          in: query
          required: false
          description: Maximum market price.
          schema:
            type: number
        - name: min_ends_at
          in: query
          required: false
          description: Minimum end timestamp or ISO 8601 date.
          schema:
            type: string
        - name: max_ends_at
          in: query
          required: false
          description: Maximum end timestamp or ISO 8601 date.
          schema:
            type: string
        - name: rewards
          in: query
          required: false
          description: Only include reward markets.
          schema:
            type: boolean
            default: false
        - name: live
          in: query
          required: false
          description: Only include live markets.
          schema:
            type: boolean
            default: false
        - name: bonds
          in: query
          required: false
          description: Only include bond-like markets.
          schema:
            type: boolean
            default: false
        - name: tags
          in: query
          required: false
          description: Comma-separated label filter.
          schema:
            type: string
            example: crypto,politics
        - name: markets
          in: query
          required: false
          description: Include nested markets in the response.
          schema:
            type: boolean
            default: true
      responses:
        '200':
          description: Unified market list
          content:
            application/json:
              example:
                success: true
                response:
                  - venue: polymarket
                    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'
                      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'
                  - venue: kalshi
                    event:
                      series_id: KXBTC
                      event_id: KXBTC-25
                      title: Bitcoin above $100,000 on Dec 31?
                      sub_title: Expires at year end
                      slug: bitcoin-above-100000-on-dec-31
                      image: https://example.com/kalshi-bitcoin.png
                      tags:
                        - crypto
                        - bitcoin
                      labels:
                        - crypto
                        - macro
                      category: Crypto
                      active: true
                      liquidity: 800000
                      volume: 3000000
                      live:
                        is_active: true
                      created_at: '2026-01-01T00:00:00'
                      ends_at: '2026-12-31T23:59:59'
                    markets:
                      - series_id: KXBTC
                        event_id: KXBTC-25
                        market_id: KXBTC-25-T100000
                        kalshi_id: T100000
                        title: Bitcoin above $100,000?
                        outcome: 'Yes'
                        description: >-
                          Resolves Yes if Bitcoin settles above $100,000 on
                          expiration.
                        image: https://example.com/kalshi-bitcoin-market.png
                        left_outcome: 'Yes'
                        right_outcome: 'No'
                        left_price: '0.58'
                        right_price: '0.42'
                        left_token_id: BRjpCHtyQLeSRWyE1yTdBQbhLkny5oEnveRijBjRoiA
                        right_token_id: F4r2GpoNU8MBMdKqP6MCBzKEHe2Mt8s5qm4GrFcJQnbJ
                        winner_token_id: ''
                        active: true
                        resolved: false
                        claimable: false
                        liquidity: '800000'
                        open_interest: '1200000'
                        volume: '3000000'
                        volume24hr: '175000'
                        dflow:
                          enabled: true
                        created_at: '2026-01-01T00:00:00'
                        updated_at: '2026-01-01T00:00:00'
                        ends_at: '2026-12-31T23:59:59'
      security: []

````