{
  "cluster_id": "kalshi:KXTRUMP-28NOV03",
  "members": [
    {
      "exchange": "kalshi",
      "market_id": "KXTRUMP-28NOV03"
    }
  ],
  "siamese": [
    {
      "cluster_id": "kalshi:KXTRUMP-28NOV03-WIN",
      "relationship": "siamese_twin",
      "reason": "Same election but different outcome threshold"
    }
  ]
}

Clusters

Get Cluster by ID

Retrieve all markets in a cross-exchange cluster and any siamese-twin relationships to other clusters.

A cluster groups markets from different exchanges that ask essentially the same question. Each member has a joined_via label:

exact — identical question and resolution criteria
resolution_variant — same question but minor resolution difference (e.g. different data source)
seed — singleton, no cross-exchange matches found yet

Siamese edges link clusters that cover the same event but ask substantively different questions (e.g. different price thresholds).

Use cases

Find the same market on multiple exchanges for arbitrage
Compare pricing across Kalshi, Polymarket, Limitless, and PFun
Discover related markets via siamese-twin links
Build cross-exchange hedging strategies

Example

Request: GET /api/v1/clusters/kalshi:KXTRUMP-28NOV03
Header: X-API-Key: YOUR_API_KEY

GET

api

clusters

{cluster_id}

{
  "cluster_id": "kalshi:KXTRUMP-28NOV03",
  "members": [
    {
      "exchange": "kalshi",
      "market_id": "KXTRUMP-28NOV03"
    }
  ],
  "siamese": [
    {
      "cluster_id": "kalshi:KXTRUMP-28NOV03-WIN",
      "relationship": "siamese_twin",
      "reason": "Same election but different outcome threshold"
    }
  ]
}

Authorizations

X-API-Key

string

header

required

Your API key (get one from the test-key endpoint above)

Path Parameters

cluster_id

string

required

Cluster ID (format: exchange:market_id of the lexicographically smallest member)

Response

Cluster members and siamese edges

A cross-exchange market cluster with all member markets and siamese-twin links to related clusters.

cluster_id

string

Cluster identifier (format: exchange:market_id of the lexicographically smallest member)

Example:

"kalshi:KXTRUMP-28NOV03"

members

object[]

All markets in this cluster across exchanges

Show child attributes

siamese

object[]

Related clusters that cover the same event but ask a different question

Show child attributes

Get Matched Markets Across Exchanges Get KLSI Market Details