Search overview

Available on all plans (Free tier included). Search covers three things: finding a series (a recurring or related group of events), finding markets and events inside one, and tailing recent listings. Most workflows that feed into historical endpoints start with Search series.

Endpoint	Use for
Search series	Find a `series_id` like `KXBTC15M` or `btc-up-or-down-15m`.
Search events	List events by text query, by `series_id`, or both.
Search markets	List markets by text query, by `series_id`, or both.
Related endpoints	Combined search, recent listings, and markets under one event.

Conventions

Topic	Behavior
Auth	`X-API-Key` on every request — see Authentication
`exchange`	`kalshi` or `polymarket` (case-insensitive). Invalid values → 400
`status`	`active` (default) or `closed`
`limit`	Integer 1–100
`offset`	Non-negative integer. Default `0`
IDs	Exchange-native source IDs (e.g. `KXBTC15M`), not internal UUIDs
Response shape	JSON arrays (except combined `GET /search`)
Field names	`snake_case`

Error handling Search series

⌘I

Getting started

Search

Historical

Arbitrage

Whales

Conventions

​Conventions

Conventions