> ## 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 Market Pairs

> Fetch cross-venue market pairs surfaced by the similarity index.



## OpenAPI

````yaml /openapi.json get /api/v1/markets/similar-pairs
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-pairs:
    get:
      tags:
        - Markets
      summary: Get Similar Market Pairs
      description: Fetch cross-venue market pairs surfaced by the similarity index.
      operationId: get-similar-market-pairs
      parameters:
        - name: sort
          in: query
          required: false
          description: Sort field.
          schema:
            type: string
            default: arbitrage
            example: ends_at
        - name: order
          in: query
          required: false
          description: Sort direction.
          schema:
            type: string
            default: DESC
            example: ASC
        - name: limit
          in: query
          required: false
          description: Maximum pairs to return.
          schema:
            type: integer
            default: 25
            example: 25
        - name: offset
          in: query
          required: false
          description: Pagination offset.
          schema:
            type: integer
            default: 0
            example: 0
      responses:
        '200':
          description: Similar market pairs
          content:
            application/json:
              example:
                success: true
                response:
                  - source:
                      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'
                        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'
                      market_id: >-
                        0xbd71b43bb47eb60dbcb41fa25df2a0ed4da612873d6e0447a2c730bd4cc25910
                    target:
                      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'
                      market_id: KXBTC-25-T100000
                    distance: 0.42
                    arbitrage: 0.02
                    volume: 3000000
                    liquidity: 800000
                    ends_at: '2026-12-31T23:59:59'
                    created_at: '2026-01-01T00:00:00'
      security: []

````