Sports

Active sports games with urgency scores and cross-provider prices

Returns active game IDs plus, when the provider indexing gate has predictfun enabled, open Predict.fun fixtures inside their scheduled start/end window. The gate is re-checked on every request (including cache hits); a gate lookup failure excludes Predict.fun (fail closed) without dropping Polymarket/Kalshi rows. Hydrates current state, drops ended games idle for more than a few minutes, and computes an urgencyScore/stale flag per game. Enriches each event with cached primary-market data, falling back to a live provider lookup when the cache is cold. Resolves each event's matching Polymarket/Kalshi slug and attaches the corresponding cross-venue match record into matchingMarkets. If no matched entry anywhere carries a Kalshi side, synthesizes one from a team-name-matching fallback lookup. Results are sorted by most-recent update, then by urgencyScore descending. Served from a shared server cache rebuilt about every 5 seconds while the endpoint is in use and never more than 60 seconds old; the Age header gives the seconds since the body was built.

get/sports/live-events

Request

  • Base URL
    https://data.kairos.trade
  • Auth
    none required

Query parameters

include_marketsboolean

When true, includes the full markets list (not just the primary market) for every event.

Response

Active games ordered by recency then urgency, plus their matched cross-provider markets.

matchingMarketsobject required

Map keyed by matched slug, one entry per event that resolved a matchingSlug.

Example response

{
  "events": [
    {
      "gameId": "12345678",
      "sport": "nba",
      "sportFamily": "basketball",
      "homeTeam": "Boston Celtics",
      "awayTeam": "Los Angeles Lakers",
      "homeScore": 88,
      "awayScore": 91,
      "status": "live",
      "period": "Q4",
      "elapsed": "02:14",
      "slug": "nba-lal-bos-2026-01-15",
      "matchingSlug": "nba-lal-bos-2026-01-15",
      "ts": "2026-07-22T23:14:05Z",
      "urgencyScore": 160,
      "primaryMarket": {
        "id": "587234",
        "question": "Will the Celtics win?",
        "slug": "nba-lal-bos-2026-01-15-bos",
        "conditionId": "0xabc123...",
        "tokenId": "10897234...",
        "outcomePrices": [
          0.6,
          0.4
        ],
        "outcomes": [
          "Yes",
          "No"
        ],
        "volumeNum": 128432.1,
        "liquidityNum": 42311,
        "sportsMarketType": "moneyline",
        "groupItemTitle": "Celtics",
        "bestBid": 0.59,
        "bestAsk": 0.61,
        "spread": 0.02,
        "provider": "polymarket",
        "outcomeMarketIds": [
          "587234",
          "587235",
          "587236"
        ]
      },
      "marketsCount": 6,
      "markets": [
        {
          "id": "587234",
          "question": "Will the Celtics win?",
          "slug": "nba-lal-bos-2026-01-15-bos",
          "conditionId": "0xabc123...",
          "tokenId": "10897234...",
          "outcomePrices": [
            0.6,
            0.4
          ],
          "outcomes": [
            "Yes",
            "No"
          ],
          "volumeNum": 128432.1,
          "liquidityNum": 42311,
          "sportsMarketType": "moneyline",
          "groupItemTitle": "Celtics",
          "bestBid": 0.59,
          "bestAsk": 0.61,
          "spread": 0.02,
          "provider": "polymarket",
          "outcomeMarketIds": [
            "587234",
            "587235",
            "587236"
          ]
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.