Skip to main content
GET
/
search
/
events
Search events
curl --request GET \
  --url https://api.oddpool.com/search/events

Documentation Index

Fetch the complete documentation index at: https://docs.oddpool.com/llms.txt

Use this file to discover all available pages before exploring further.

An event groups all the outcome markets for one question. “Fed Rate Decision March 2026” is one event with markets for each rate-cut size; a single 15-minute Bitcoin event has up/down markets for that window. You must pass either q or series_id (or both). Requests with neither return 400. To find a series_id, use Search series.

​
Parameters

​
q
string
Full-text search on title. Required when series_id is not provided.
​
series_id
string
Filter to one series. Examples: KXBTC15M, btc-up-or-down-15m, KXFEDDECISION. Required when q is not provided.
​
exchange
string
kalshi or polymarket.
​
status
string
default:"active"
active or closed.
​
category
string
Exact category match.
​
min_volume
integer
Minimum aggregate volume across child markets.
​
discovered_after
string
ISO timestamp filter on discovered_at.
​
sort_by
string
default:"relevance"
relevance, newest, markets, volume, or liquidity. relevance requires q; without q the default is newest.
​
limit
integer
default:"20"
1-100.
​
offset
integer
default:"0"
Pagination offset. The response is a bare JSON array — increment offset by limit until you receive an empty array.

​
Examples

​
List active events in a series

Use series_id to scope results — typical for “show me what’s tradable in this series right now” workflows. 
curl -H "X-API-Key: your_api_key" \
  "https://api.oddpool.com/search/events?series_id=KXBTC15M&status=active&limit=10"

​
Free-text search

Useful when you don’t know the series_id or want to span series. 
curl -H "X-API-Key: your_api_key" \
  "https://api.oddpool.com/search/events?q=election&sort_by=volume"

​
Response

[
  {
    "event_id": "KXBTC15M-26MAY040400",
    "exchange": "kalshi",
    "series_id": "KXBTC15M",
    "title": "BTC Up or Down - 15 minutes",
    "category": "Crypto",
    "status": "active",
    "image_url": "https://d1lvyva3zy5u58.cloudfront.net/series-images-webp/KXBTC15M.webp?size=sm",
    "discovered_at": "2026-05-04T00:05:52Z",
    "market_count": 1,
    "total_volume": 0,
    "total_liquidity": 0,
    "market_questions": ["BTC price up in next 15 mins?"]
  }
]

​
Errors

CodeReason
400Neither q nor series_id provided.