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

> Fetch markets that the similarity index considers close to the supplied market.



## OpenAPI

````yaml /openapi.json get /api/v1/markets/similar
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/similar:
    get:
      tags:
        - Markets
      summary: Get Similar Markets
      description: >-
        Fetch markets that the similarity index considers close to the supplied
        market.
      operationId: get-similar-markets
      parameters:
        - name: market_id
          in: query
          required: true
          description: Condition ID for Polymarket or market ID for Kalshi.
          schema:
            type: string
        - name: venue
          in: query
          required: false
          description: >-
            Optional venue selector when you want to scope the lookup to a
            specific venue.
          schema:
            type: string
            example: polymarket
      responses:
        '200':
          description: Similar markets
          content:
            application/json:
              example:
                success: true
                response:
                  - 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'
                      updated_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'
                    distance: 0.42
                    market_id: KXBTC-25-T100000
      security: []

````