Prediction Hunt API

Markets

Browse and search all markets across platforms. Paginated via cursor. Each market includes its latest price data.

GET/v2/markets

Query Parameters

platformstring

Filter by platform: polymarket, kalshi, predictit, prophetx, opinion.

statusstring

Market status: active, closed, or all. Default: active.

categorystring

Category filter (e.g. 'sports', 'politics', 'economics').

qstring

Full-text search on market title.

limitinteger

Results per page. Default: 50, max: 500.

cursorstring

Pagination cursor from previous response.

Response Schema

marketsobject[]

List of markets matching the filters.

idinteger

Internal market ID.

market_idstring

Platform-native market identifier.

platformstring

Source platform (polymarket, kalshi, etc.).

titlestring

Market title / question.

categorystring

Market category (sports, politics, economics, etc.).

statusstring

Market status (active, closed).

expiration_datestring

ISO 8601 expiration timestamp.

source_urlstring

Direct link to the market on the platform.

priceobject

Latest price snapshot for this market.

yes_bidnumber

Best bid for YES.

yes_asknumber

Best ask for YES.

no_bidnumber

Best bid for NO.

no_asknumber

Best ask for NO.

last_pricenumber

Last traded price.

volumeinteger

Trading volume.

liquiditynumber

Current liquidity (USD).

next_cursorstring

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

total_countinteger

Total number of markets matching the filters (across all pages).

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

Platform

Status

Response

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