Skip to main content
GET
/
api
/
comparisons
List comparisons
curl --request GET \
  --url http://localhost:8000/api/comparisons \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "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"
    }
  ],
  "next_cursor": "eyJpZCI6MTA0Mn0=",
  "has_more": true,
  "total_count": 4391
}

Authorizations

Authorization
string
header
required

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

Query Parameters

bucket
string

Filter comparisons by topic bucket.

Example:

"politics"

confidence
enum<string>

Filter by the confidence level of the match.

Available options:
high,
medium,
low
relationship_type
enum<string>

Filter by the type of relationship between the matched events.

Available options:
exact_match,
similar
cursor
string

Cursor for pagination. Pass the next_cursor value from a previous response to get the next page.

limit
integer
default:50

Maximum number of comparisons to return per page.

Required range: 1 <= x <= 200

Response

A paginated list of cross-platform comparisons.

Paginated response containing cross-platform comparisons.

data
object[]
next_cursor
string | null

Cursor to pass for the next page of results. Null if no more pages.

has_more
boolean

Whether there are more results available.

total_count
integer

Total number of results matching the query.