Skip to main content
GET
/
api
/
comparisons
/
{comparison_id}
Get comparison by ID
curl --request GET \
  --url http://localhost:8000/api/comparisons/{comparison_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": 1042,
  "polymarket_id": "0xbtc100k",
  "kalshi_id": "BTC-100K-2025",
  "polymarket_title": "Bitcoin to $100K in 2025?",
  "kalshi_title": "Will Bitcoin reach $100K in 2025?",
  "relationship_type": "exact_match",
  "confidence": "high",
  "reasoning": "Both markets resolve on the same condition: Bitcoin reaching $100,000 at any point in 2025.",
  "bucket": "crypto",
  "subtag": "bitcoin",
  "kalshi_markets": [
    {
      "venue": "kalshi",
      "venue_market_id": "BTC-100K-2025-YES",
      "title": "Bitcoin $100K - Yes",
      "mid_price": 0.42,
      "best_bid": 0.41,
      "best_ask": 0.43,
      "spread": 0.02,
      "volume": 1200000,
      "volume_24h": 89000
    }
  ],
  "polymarket_markets": [
    {
      "venue": "polymarket",
      "venue_market_id": "0xbtc100k-yes",
      "title": "Bitcoin to $100K in 2025?",
      "mid_price": 0.44,
      "best_bid": 0.43,
      "best_ask": 0.45,
      "spread": 0.02,
      "volume": 2340000,
      "volume_24h": 156000
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Use your API key as a Bearer token. Example: Authorization: Bearer mk_live_...

Path Parameters

​
comparison_id
integer
required

The unique comparison ID.

Example:

1042

Response

The comparison with markets from both venues.

A cross-platform comparison mapping equivalent or similar events between Kalshi and Polymarket.

​
id
integer
required

Unique comparison identifier.

Example:

1042

​
polymarket_id
string
required

The Polymarket event identifier.

Example:

"0xbtc100k"

​
kalshi_id
string
required

The Kalshi event identifier.

Example:

"BTC-100K-2025"

​
relationship_type
enum<string>
required

How closely the two events correspond.

Available options:
exact_match,
similar
​
confidence
enum<string>
required

Confidence level in the accuracy of the mapping.

Available options:
high,
medium,
low
​
polymarket_title
string

Title of the event on Polymarket.

Example:

"Bitcoin to $100K in 2025?"

​
kalshi_title
string

Title of the event on Kalshi.

Example:

"Will Bitcoin reach $100K in 2025?"

​
reasoning
string | null

Human-readable explanation of why these events were matched.

Example:

"Both markets resolve on the same condition: Bitcoin reaching $100,000 at any point in 2025."

​
bucket
string | null

Topic bucket for grouping comparisons.

Example:

"crypto"

​
subtag
string | null

Sub-category within the bucket.

Example:

"bitcoin"

​
kalshi_markets
object[]

Markets from Kalshi for this comparison.

​
polymarket_markets
object[]

Markets from Polymarket for this comparison.