---
title: "Cross-platform matching-market records for a set of market slugs"
method: GET
path: "/sports/matching-markets"
tags: ["Sports"]
---

# Cross-platform matching-market records for a set of market slugs

`GET /sports/matching-markets`

## Request

- Base URL: `https://data.kairos.trade`
- URL: `https://data.kairos.trade/sports/matching-markets`
- Auth: none required

Returns the cross-venue match record for each requested market slug, keyed by slug. Provider entries can include Polymarket, Kalshi, Predict.fun, and Hyperliquid. Slugs with no cross-venue match are silently omitted from the response object (not returned as null). When `live=true`, the Kalshi side of every matched entry is refreshed in-place with a live price (in cents / 100, 4 decimal places); a correction is applied when a stale price appears to be on the wrong side of a binary flip. Responses are cacheable, briefly when `live=true`, longer otherwise.

## Query parameters

- `slugs` string, required
- `live` 'true' | 'false'

## Response `200`

Map of slug to matching-market record. Returns `{}` if `slugs` parses to no non-empty entries.

- SportsMatchingMarketsResponse: Map keyed by requested game slug. Slugs with no cache entry, or an unparseable cache value, are omitted from this object entirely.

## Other responses

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

---

[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)