Prediction Hunt API

Matching Markets

Find equivalent markets across different prediction market platforms (Polymarket, Kalshi, etc.) using platform-specific identifiers — Polymarket slugs and Kalshi ticker IDs.

GET/matching-markets

Query Parameters

polymarket_slugsstring

A Polymarket market slug to find matches for. Provide exactly one identifier per request — either a Polymarket slug or a Kalshi ticker, not both.

kalshi_tickersstring

A Kalshi event ticker to find matches for. Provide exactly one identifier per request — either a Polymarket slug or a Kalshi ticker, not both.

api_keystring

Legacy method. Can be passed as a query parameter, but header-based authentication is highly recommended for security.

Response Schema

successboolean

Indicates if the request was successful.

countinteger

Number of events matching the provided inputs.

eventsobject[]
titlestring

The human-readable name of the event (e.g. "2026 NBA Champions").

confidencestring

Match confidence level: "high" or "medium". Events with "low" confidence are excluded.

groupsobject[]
titlestring

The specific market group title (e.g. "Los Angeles Lakers").

marketsobject[]

Array of matched markets: source, source_url, id.

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

Market Identifiers

1 per request
PolymarketActive
KalshiPreview

Response

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