Skip to main content
GET
Search markets by text query

Authorizations

X-Client-Id
string
header
required

Credential client id (kairos_ck_...). Must be sent together with X-Api-Key and X-Api-Secret.

X-Api-Key
string
header
required

64-char hex API key.

X-Api-Secret
string
header
required

64-char hex API secret.

Query Parameters

q
string
required

Search query text.

Required string length: 1 - 200
limit
integer
default:50
Required range: 1 <= x <= 100
provider
string

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_id
string

Legacy alias for provider. See provider.

include_expired
boolean
default:false
statuses
string[]

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

categories
string[]

Repeatable category filter. Passed through unvalidated.

tags
string[]

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

Response

Search results, visibility-filtered by active provider.

results
object[]
required
meta
object
required