Prediction Hunt

↑ ↓ move · Enter open · Esc close

API docs
REST API / Discover / Events

Events

List all tracked events with their matched market groups. Events are the real-world occurrences that markets are tied to. Each event can have multiple matched market groups across platforms.

GET/v2/events
Plans All plansMatched quota: see Rate limits

Parameters

event_typestring

Filter: sports, election, economics, or all. Default: all.

statusstring

Filter by status: active or all. Default: active. Use all to include completed events.

tagsstring

For sports events: nfl, nba, mlb, nhl, cfb, epl, etc. Comma-separated.

datestring

Filter by event date (YYYY-MM-DD).

qstring

Search event name.

typesstring

Comma-separated market classes to keep in each event's groups: moneyline, spread, total, player_prop, other - or all. Filters by market_class. Default: all classes.

limitinteger

Default: 20, max: 100.

cursorstring

Pagination cursor from previous response.

Response

eventsobject[]

List of events matching the filters.

Show 6 fields
idinteger

Internal event ID.

event_namestring

Event name (e.g. "NBA: Lakers vs Celtics").

event_typestring

Category: sports, election, economics.

event_datestring

Date of the event (YYYY-MM-DD).

statusstring

Event status in the response: active or completed. The status filter accepts active or all.

groupsobject[]

Matched market groups for this event.

Show 11 fields
group_idinteger

Internal match group ID.

titlestring

Group title (e.g. "Los Angeles Lakers").

platform_countinteger

Number of platforms with markets in this group.

platformsstring[]

List of platform names (e.g. ["polymarket", "kalshi"]).

market_classstring | null

Type class of this group: moneyline, spread, total, player_prop, or other. null on non-sports groups. Switch on this - do not parse titles.

market_typestring | null

Specific type (e.g. spread, 1h_total, player_points). null for game moneylines and non-sports groups. Open-ended; branch on market_class.

periodstring | null

full or 1H on sports groups; absent on non-sports groups.

linenumber | null

Line for spread, total or player-prop groups; absent on non-sports groups.

sidestring | null

home/away for spreads, over/under for totals and player props; absent on non-sports groups.

playerstring | null

Player name on player-prop groups; absent on non-sports groups.

teamstring | null

Full team name on team-line groups; absent on non-sports groups.

next_cursorstring

Opaque cursor for the next page. Null if no more results.

total_countinteger

Total number of events matching the filters.

Full API response