Prediction Hunt API

Search

Search for events and markets by text query. Returns matched events with their market groups, cross-platform prices, and group IDs for use with other endpoints. Supports filtering by event type and status.

GET/v2/search

Query Parameters

qstringRequired

Search query (case-insensitive substring match on event names and group titles).

event_typestring

Filter by event type (e.g. election, Politics, Science and Technology).

statusstring

Filter by status: active (default), completed, or all.

date_fromstring

Only events on or after this date (ISO 8601, e.g. 2026-06-01).

date_tostring

Only events on or before this date (ISO 8601, e.g. 2026-12-31).

limitinteger

Max results to return (1-100, default 20).

cursorstring

Pagination cursor from a previous response.

Response Schema

querystring

The search query that was used.

countinteger

Number of events returned.

eventsobject[]

Matching events with groups and prices.

event_namestring

Name of the event.

event_typestring

Event category (election, Politics, etc.).

event_datestring

Event date (ISO 8601).

statusstring

active or completed.

group_countinteger

Number of matched groups in this event.

groupsobject[]

Matched market groups.

group_idinteger

Group ID (use with /v2/unified-orderbook).

titlestring

Group title (candidate / proposition name).

platform_countinteger

Number of platforms with this market.

marketsobject[]

Markets in this group.

platformstring

Platform name (kalshi, polymarket, etc.).

market_idstring

Platform-native market ID.

source_urlstring

Direct link to the market on the platform.

last_pricenumber | null

Most recent price.

yes_bidnumber | null

Current YES bid price.

yes_asknumber | null

Current YES ask price.

next_cursorstring | null

Cursor for next page of results (null if no more).

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

Parameters

Search QueryRequired

Event Type

Date From

Date To

Limit

Response

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