Sign in
MatchedMarkets

Fetch matched market clusters

Returns connected clusters of semantically matched markets across venues. Use this endpoint to browse or anchor market-level matches without flattening the response into pairwise rows.

get/v0/matched-market-clusters

Query parameters

marketIdstring

Anchor the response to a specific market ID.

slugstring

Anchor the response to a specific market slug.

urlstring

Anchor the response to a specific market URL.

querystring

Text search across cluster titles.

categorystring

Filter both sides of matched edges by market 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 market clusters.

Changes

Changed in 2 of the 8 revisions of this API.38

  • 0f61c1c7b73537See the full diff
    • ▲

      the query request parameter relation was restricted to a list of enum values

      request-parameter-became-enum

    • ▲

      for the query request parameter relation, default value identity was added

      request-parameter-default-value-added

    • ▲

      for the query request parameter relations, default value identity was added

      request-parameter-default-value-added

    • ○

      added the new optional query request parameter category

      new-optional-request-parameter

    • ○

      added the new optional query request parameter query

      new-optional-request-parameter

    • ○

      added the new enum value disjoint to the query request parameter relation

      request-parameter-enum-value-added

    • ○

      added the new enum value identity to the query request parameter relation

      request-parameter-enum-value-added

    • ○

      added the new enum value overlap to the query request parameter relation

      request-parameter-enum-value-added

    • ○

      added the new enum value subset to the query request parameter relation

      request-parameter-enum-value-added

    • ○

      added the new enum value superset to the query request parameter relation

      request-parameter-enum-value-added

  • 9c42ae8bcc301See the full diff
    • ○

      endpoint added

      endpoint-added