Fast simple search for navbar/autocomplete overlay

Primary search endpoint behind the web navbar overlay. Supports sort/offset/pagination and optional server-side event grouping (group_results), then applies provider-visibility filtering. When group_results=true, best-effort enrichment (never fails the request) adds classifiedGroups/absorbedMarketIds (interactive ladder groups) and correlations (a cross-venue similar-market rail, similarity above a threshold, capped at 4 counterparts per result market). When group_results=false, only correlations is attached.

get/search/simple

Request

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

Query parameters

qstring required

limitinteger

offsetinteger

providerstring

provider_idstring

Legacy alias for provider.

tagsstring[]

Repeatable platform-tag-slug filter.

statusesstring[]

sort_by'relevance' | 'volume_24h' | 'newest' | 'ending_soon'

sort_order'asc' | 'desc'

include_totalboolean

Include a best-effort meta.total (falls back to the filtered count if any rows were dropped by visibility filtering).

include_expiredboolean

group_resultsboolean

Group markets by event server-side, producing groups/singles in the response.

Response

Simple-search result envelope, optionally grouped and enriched with classified ladders + cross-venue correlations.

absorbedMarketIdsstring[]

Market/outcome ids already rendered inside classifiedGroups — the overlay should not also render them as standalone rows.

correlationsobject

Map of result market_id -> up to 4 similar cross-venue counterpart markets, sorted by similarity descending.

Example response

{
  "results": [
    {
      "market_id": "KXPRES-28-DJT",
      "provider_id": 1,
      "provider": "kalshi",
      "status": "open"
    }
  ],
  "groups": [
    {
      "representative": {
        "market_id": "KXPRES-28-DJT",
        "provider_id": 1,
        "provider": "kalshi",
        "status": "open"
      },
      "markets": [
        {
          "market_id": "KXPRES-28-DJT",
          "provider_id": 1,
          "provider": "kalshi",
          "status": "open"
        }
      ]
    }
  ],
  "singles": [
    {
      "market_id": "KXPRES-28-DJT",
      "provider_id": 1,
      "provider": "kalshi",
      "status": "open"
    }
  ]
}

Changes

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