--- title: "Cross-venue cluster membership for a set of markets" method: GET path: "/market-clusters" tags: ["Markets"] --- # Cross-venue cluster membership for a set of markets `GET /market-clusters` ## Request - Base URL: `https://data.kairos.trade` - URL: `https://data.kairos.trade/market-clusters` - Auth: none required Resolves each `:` reference to its equivalence cluster at the requested tier floor and returns the cluster's other live members. Members listed on a venue whose indexing is switched off, or whose status is settled/closed/resolved, are excluded; a reference whose cluster keeps fewer than two live members after that filter is omitted from the response entirely. Membership is capped at 32 per cluster, with `truncated` and the stored `size` stating what was left out. ## Query parameters - `markets` string, required - `floor` 'exact' | 'semantic' ## Response `200` Cluster membership keyed by the requested reference. - MarketClustersResponse - `clusters` object, required: Keyed by the requested `:` reference. A reference with no cluster, or whose cluster has fewer than two live members after filtering, is absent — the map is never padded with empties. - `count` integer, required: Number of entries in `clusters`. - `floor` 'exact' | 'semantic', required ## Other responses - `400`: Unknown `floor`, no parseable `:` reference, or more than 200 references. - `422`: Request failed FastAPI parameter validation. - `429`: Rate limit exceeded for this route's sliding window, keyed on the session `sub` when authenticated and on the trusted client IP otherwise. Honor `Retry-After`. A per-API-key data ceiling (set per credential) rejects with `{"detail": "API key data rate limit exceeded"}` instead of the `error` envelope below. - `503`: The cluster store could not be queried. --- [API](https://skmtc.dev/kairos/apis/kairos-data-api.md) - [All operations](https://skmtc.dev/kairos/apis/kairos-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kairos/apis/kairos-data-api/revisions/cf6b76079e38?raw)