v8

latestOpenAPI 3.0.0raw.githubusercontent.com2026-06-0931639.5 KB
MatchedMarkets

Fetch 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.

get/v0/matched-event-clusters

Query parameters

eventIdstring

Anchor the response to a specific event ID.

slugstring

Anchor the response to a specific event slug.

urlstring

Anchor the response to a specific event URL.

querystring

Text search across cluster titles.

categorystring

Filter both sides of matched edges by event category.

relationsstring

Comma-separated relation filter. Valid values: identity (same resolution), subset (A yes implies B yes), superset (B yes implies A yes), overlap (some shared scenarios), and disjoint (mutually exclusive). Defaults to identity. For subset and superset, direction follows the pairwise edge direction returned in rawMatches when includeRawMatches=true.

relation'identity' | 'subset' | 'superset' | 'overlap' | 'disjoint'

Single relation filter. Alias for relations.

minConfidencenumber
venuesstring

Comma-separated venue allow-list.

excludeVenuesstring

Comma-separated venue deny-list.

minVenuesinteger

Minimum number of venues required in a cluster.

withOrderbookboolean

Require at least one live orderbook on each matched edge.

updatedSincestring date-time

Only include matches updated after this timestamp.

includeRawMatchesboolean

Include the pairwise match edges used to build each cluster.

sort'volume' | 'confidence'
limitinteger
offsetinteger
edgeLimitinteger

Maximum number of pairwise edges to scan before clustering.

Response

Matched event clusters.

All 3 operations