---
title: "Fetch matched event clusters"
method: GET
path: "/v0/matched-event-clusters"
tags: ["MatchedMarkets"]
---

# Fetch matched event clusters

`GET /v0/matched-event-clusters`

Returns connected clusters of semantically matched events across venues. Use this endpoint to browse or anchor event-level matches while preserving each venue's child markets.

## Query parameters

- `eventId` string
- `slug` string
- `url` string
- `query` string
- `category` string
- `relations` string
- `relation` 'identity' | 'subset' | 'superset' | 'overlap' | 'disjoint'
- `minConfidence` number
- `venues` string
- `excludeVenues` string
- `minVenues` integer
- `withOrderbook` boolean
- `updatedSince` string, date-time
- `includeRawMatches` boolean
- `sort` 'volume' | 'confidence'
- `limit` integer
- `offset` integer
- `edgeLimit` integer

## Response `200`

Matched event clusters.

## Changes

- **2026-05-24** `0f61c1c7b735` — 3 breaking, 7 info
  - the `query` request parameter `relation` was restricted to a list of enum values
  - for the `query` request parameter `relation`, default value `identity` was added
  - for the `query` request parameter `relations`, default value `identity` was added
  - added the new optional `query` request parameter `category`
  - …6 more
- **2026-05-24** `9c42ae8bcc30` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/pmxt-dev/apis/pmxt-hosted-router-api-2/changes/v0/matched-event-clusters/get.md)

---

[API](https://skmtc.dev/pmxt-dev/apis/pmxt-hosted-router-api-2.md) · [All operations](https://skmtc.dev/pmxt-dev/apis/pmxt-hosted-router-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pmxt-dev/pmxt-hosted-router-api-2/revisions/50653c6d513e/schema)