Prediction Hunt API

Prices

Fetch current prices for up to 100 markets in a single request.

GET/v2/prices/bulk

Query Parameters

idsstringRequired

Comma-separated list of platform:market_id pairs (e.g. polymarket:abc,kalshi:KXFED-26). Max 100.

Response Schema

pricesobject

Map of platform:market_id to current price data.

yes_bidnumber

Best bid for YES.

yes_asknumber

Best ask for YES.

last_pricenumber

Last traded price.

timestampstring

Timestamp of the price snapshot (ISO 8601).

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

Market IDsRequired

Response

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