Skip to main content

Documentation Index

Fetch the complete documentation index at: https://pmxt.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

Given an event on any venue, find the corresponding event on every other venue and map all child markets across them. Instead of matching one market at a time, this returns the full cross-venue mapping in a single call. An Event is the parent container — it holds multiple Markets, each with their own Outcomes. Event matching maps the entire tree across venues.

fetchEventMatches

import pmxt

router = pmxt.Router(pmxt_api_key="pmxt_live_...")

event_matches = router.fetch_event_matches(event_id="e344d660-...")

for em in event_matches:
    print(em.event.title)
    for mm in em.market_matches:
        print(f"  {mm.relation} ({mm.confidence}): {mm.market.title}")

Parameters

ParameterTypeDefaultNotes
eventIdstringInternal PMXT event ID.
slugstringEvent slug (alternative to eventId).
relationstringFilter market matches to a specific relation type.
minConfidencenumberOnly return matches above this threshold (0–1).
limitintegerMax event matches to return.
includePricesbooleanfalseAttach live prices to each market match.

Response shape

[
  {
    "event": {
      "eventId": "...",
      "title": "2028 US Presidential Election"
    },
    "marketMatches": [
      {
        "market": { "marketId": "...", "title": "Will Newsom win?" },
        "relation": "identity",
        "confidence": 0.92,
        "reasoning": "Same candidate, same office, same election cycle."
      },
      {
        "market": { "marketId": "...", "title": "Will DeSantis win?" },
        "relation": "identity",
        "confidence": 0.89,
        "reasoning": "Same candidate — different bracket formatting on Kalshi."
      }
    ]
  }
]
Each matched event contains its full list of cross-venue market matches. Markets that exist on one venue but not the other are omitted from the response — only matched pairs appear.

When to use event matching vs market matching

You have…Use
A single market questionFind Similar Markets
An event with many child marketsFind Similar Events (this page)
Event matching is more efficient when you care about the full picture — it maps all child markets in one call instead of N separate market match calls.