Prediction Hunt API

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

Query Parameters

event_typestring

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

statusstring

Filter by status: active (event date today or future), completed (past), or all. Default: active.

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.

limitinteger

Default: 50, max: 200.

cursorstring

Pagination cursor from previous response.

Response Schema

eventsobject[]

List of events matching the filters.

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: active (event date is today or future) or completed (event date has passed).

groupsobject[]

Matched market groups for this event.

group_idinteger

Internal match group ID.

titlestring

Group title (e.g. "lakers win").

platform_countinteger

Number of platforms with markets in this group.

platformsstring[]

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

next_cursorstring

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

total_countinteger

Total number of events matching the filters.

Authentication

API Key

To secure your requests, we strongly recommend passing your API key via the X-API-Key header. This prevents sensitive keys from being exposed in access logs or browser history.

Request HeaderX-API-Key: pmx_test_5e8f...

Rate Limits

API rate limits are enforced based on the tier associated with your API key. Limits are tracked on two dimensions: requests per second and requests per month. Only successful responses (where success is true) count toward your monthly quota.

Current usage is returned in every API response via the following headers:

Response HeadersX-RateLimit-Limit-Second: 10X-RateLimit-Remaining-Second: 9X-RateLimit-Limit-Month: 1000X-RateLimit-Remaining-Month: 842

If you exceed a rate limit, the API returns a 429 status with a Retry-After header indicating when you can resume.

Request

Live API Key

Demo Mode

Verified

Filters

Event Type

Status

Response

Enter an API key and click "Try it now" to see the live response data.