Search

Search markets by text query

Unified market search. Results are post-filtered to drop rows whose provider is currently inactive.

get/search/markets

Request

  • Base URL
    https://data.kairos.trade
  • Auth
    API key in header X-Client-Id and API key in header X-Api-Key and API key in header X-Api-Secret

Query parameters

qstring required

Search query text.

limitinteger
providerstring

Filter by provider id (e.g. kalshi, polymarket, predictfun, opinion, dome). Validated dynamically against active providers; 400 if unrecognized. provider_id is accepted as a legacy alias — if both are given they must match or the request 400s.

provider_idstring

Legacy alias for provider. See provider.

include_expiredboolean
statusesstring[]

Repeatable market-status filter (e.g. open, closed, settled). Passed through unvalidated.

categoriesstring[]

Repeatable category filter. Passed through unvalidated.

tagsstring[]

Repeatable platform-tag-slug filter (query param name is tags; internally platform_tags).

Response

Search results, visibility-filtered by active provider.

Example response

{
  "results": [
    {
      "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.