Skip to main content
GET
/
match
/
{contractID}
Match a contract
curl --request GET \
  --url https://surface.surf/api/v1/match/{contractID} \
  --header 'X-API-Key: <api-key>'
{
  "source": {
    "id": "KXNBAGAME-26FEB28LACLAL-LAL",
    "exchange": "kalshi",
    "question": "Will the Lakers beat the Clippers on Feb 28?",
    "url": "https://kalshi.com/markets/kxnbagame/lal-vs-lac-lal-wins",
    "rules": "This market resolves YES if the Los Angeles Lakers defeat the Los Angeles Clippers..."
  },
  "match": {
    "id": "0x9f2d...",
    "exchange": "polymarket",
    "question": "Lakers vs Clippers — Lakers win?",
    "url": "https://polymarket.com/event/lakers-vs-clippers-feb-28"
  },
  "confidence": 0.97
}

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
contractID
string
required

A Kalshi contract ticker (e.g. KXNBAGAME-26FEB28LACLAL-LAL) or a Polymarket token ID (hex string).

Response

Match found.

​
source
object
required

The contract you queried. Exchange is determined by the format of contractID.

​
match
object
required

The matched contract on the other exchange.

​
confidence
number<float>
required

Match confidence score between 0 and 1. Scores above 0.9 are considered high-confidence.

Required range: 0 <= x <= 1