Skip to main content
GET
Search events
An event groups the outcome markets for one tradable window (e.g. one 15-minute Bitcoin interval). Provide q, series_id, or both.

Request

Query parameters

q
string
Substring match on title, subtitle, source event id, and market questions. Required unless series_id is set.
series_id
string
Filter to one series (e.g. KXBTC15M). Required unless q is set.
exchange
string
kalshi or polymarket.
category
string
Exact category match.
status
string
default:"active"
active or closed.
min_volume
number
Minimum aggregate volume across child markets.
discovered_after
string
ISO 8601 timestamp; discovered_at >= discovered_after.
sort_by
string
relevance, newest, markets, volume, or liquidity. Defaults to relevance when q is set, otherwise newest.
limit
integer
default:"20"
Number of results (1–100).
offset
integer
default:"0"
Pagination offset.

Response

Returns a JSON array of event objects.
event_id
string
Source event ticker / ID.
exchange
string
kalshi or polymarket.
series_id
string
Parent series source ID.
title
string
Event title.
url
string
Exchange web page URL when available.
status
string
active or closed.
market_count
integer
Number of child markets.
total_volume
number
Sum of child market volume.
total_liquidity
number
Sum of child market liquidity.
market_questions
array
Questions from child markets.

Examples

Active events in a Kalshi BTC 15m series