Skip to main content
GET
/
v2
/
matching-markets
Get Matching Markets
curl --request GET \
  --url https://api.predexon.com/v2/matching-markets \
  --header 'x-api-key: <api-key>'
{
  "query": {
    "condition_id": "<string>",
    "market_slug": "<string>",
    "market_id": "<string>",
    "title": "<string>",
    "status": "<string>",
    "platform": "POLYMARKET"
  },
  "matches": {},
  "summary": {
    "total_matches": 123,
    "exact_matches": 123,
    "related_matches": 123,
    "platforms": [
      "<string>"
    ]
  }
}

​
Overview

Find matching markets across prediction market platforms. Given a Polymarket identifier (condition ID, market slug, or market ID) OR a Kalshi market ticker, discover equivalent or related markets on the other platform.
Provide exactly one identifier parameter, not multiple.
LLM-Based Matching: Market matching is powered by large language models (LLMs). There is a small percentage of markets where hallucinations may occur, resulting in invalid or incorrect matches. Always verify matches before making trading decisions.

​
Match Types

Exact Matches

Same underlying event with equivalent or near-equivalent resolution criteria. Similarity score >= 95.

Related Matches

Similar or correlated events (same entity different outcome, or same event different candidate). Similarity score between 80 and 95.

​
Status Values

StatusDescription
activeMarket is open for trading
closedMarket is closed/resolved
The similarity field may be null for matches created before January 4th, 2025.

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
polymarket_condition_id
string | null

Polymarket condition ID (hex hash)

​
polymarket_market_slug
string | null

Polymarket market slug

​
polymarket_market_id
string | null

Polymarket market ID (numeric)

​
kalshi_market_ticker
string | null

Kalshi market ticker

​
match_type
enum<string> | null

Filter by match type: 'exact', 'related', or 'all' (default: all) Match type filter for cross-platform market matching.

Available options:
exact,
related,
all

Response

Successful Response

Response for Polymarket market matching query.

​
query
PolymarketQueryInfo · object
required

Polymarket query information.

​
matches
Matches · object
required
​
summary
MatchSummary · object
required

Summary of matches.