Skip to main content
GET
/
v1
/
matching-markets
/
pairs
# Get top matched pairs
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/matching-markets/pairs?limit=10"

# Filter by minimum similarity
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/matching-markets/pairs?min_similarity=95&limit=20"

{
  "pairs": [
    {
      "POLYMARKET": {
        "market_slug": "will-the-carolina-hurricanes-win-the-metropolitan-division-123",
        "title": "Will the Carolina Hurricanes win the Metropolitan Division?"
      },
      "KALSHI": {
        "market_ticker": "KXNHLMETROPOLITAN-26-CAR",
        "title": "Will Carolina Hurricanes win the NHL Metropolitan Division?",
        "yes_subtitle": "Carolina Hurricanes"
      },
      "similarity": 97,
      "explanation": "Same entity (Carolina Hurricanes), same outcome (win the 2025-26 NHL Metropolitan Division), same timeframe (2025-26 regular season) - will always resolve identically."
    },
    {
      "POLYMARKET": {
        "market_slug": "will-bitcoin-hit-150k-in-2025",
        "title": "Will Bitcoin hit $150,000 in 2025?"
      },
      "KALSHI": {
        "market_ticker": "KXBTC-25DEC31-B150000",
        "title": "Bitcoin above $150,000?",
        "yes_subtitle": "Yes"
      },
      "similarity": 96,
      "explanation": "Same underlying asset (Bitcoin), same price threshold ($150,000), same timeframe (end of 2025) - will always resolve identically."
    }
  ],
  "pagination": {
    "limit": 20,
    "count": 20,
    "pagination_key": "eyJzaW1pbGFyaXR5Ijo5NSwibWF0Y2hfaWQiOiJhYmMxMjMifQ==",
    "has_more": true
  }
}

​
Overview

Get all active exact-matched market pairs between Polymarket and Kalshi. This endpoint returns pre-computed pairs where both markets are currently active, ordered by similarity score (highest first).
​
min_similarity
integer
Minimum similarity score filter (0-100). Only return pairs with similarity >= this value.
​
limit
integer
default:"50"
Maximum number of pairs to return (1-50)
​
pagination_key
string
Pagination key for cursor-based pagination (from previous response)
​
pairs
array
​
pagination
object
# Get top matched pairs
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/matching-markets/pairs?limit=10"

# Filter by minimum similarity
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/matching-markets/pairs?min_similarity=95&limit=20"

{
  "pairs": [
    {
      "POLYMARKET": {
        "market_slug": "will-the-carolina-hurricanes-win-the-metropolitan-division-123",
        "title": "Will the Carolina Hurricanes win the Metropolitan Division?"
      },
      "KALSHI": {
        "market_ticker": "KXNHLMETROPOLITAN-26-CAR",
        "title": "Will Carolina Hurricanes win the NHL Metropolitan Division?",
        "yes_subtitle": "Carolina Hurricanes"
      },
      "similarity": 97,
      "explanation": "Same entity (Carolina Hurricanes), same outcome (win the 2025-26 NHL Metropolitan Division), same timeframe (2025-26 regular season) - will always resolve identically."
    },
    {
      "POLYMARKET": {
        "market_slug": "will-bitcoin-hit-150k-in-2025",
        "title": "Will Bitcoin hit $150,000 in 2025?"
      },
      "KALSHI": {
        "market_ticker": "KXBTC-25DEC31-B150000",
        "title": "Bitcoin above $150,000?",
        "yes_subtitle": "Yes"
      },
      "similarity": 96,
      "explanation": "Same underlying asset (Bitcoin), same price threshold ($150,000), same timeframe (end of 2025) - will always resolve identically."
    }
  ],
  "pagination": {
    "limit": 20,
    "count": 20,
    "pagination_key": "eyJzaW1pbGFyaXR5Ijo5NSwibWF0Y2hfaWQiOiJhYmMxMjMifQ==",
    "has_more": true
  }
}

​
Use Cases

Arbitrage Discovery

Find price discrepancies between identical markets on different platforms

Cross-Platform Analysis

Compare liquidity and volume across platforms for the same event

Market Coverage

Identify which markets exist on both platforms

Price Feeds

Build composite price feeds from multiple sources
Pairs are ordered by similarity score (highest first). Use min_similarity to filter for high-confidence matches only.

Authorizations

​
x-api-key
string
header
required

API key for authentication. Get your free key at dashboard.predexon.com

Query Parameters

​
min_similarity
integer | null

Minimum similarity score (0-100)

Required range: 0 <= x <= 100
​
limit
integer
default:50

Maximum number of pairs to return

Required range: 1 <= x <= 50
​
pagination_key
string | null

Cursor for pagination from previous response

Response

Successful Response

Response for matched pairs endpoint.

​
pairs
MatchedPair · object[]
required
​
pagination
MatchedPairsPagination · object
required

Pagination for matched pairs endpoint.