Prediction Hunt API

Matching Markets by URL

Find matching markets by providing a URL from any supported platform. The platform is auto-detected from the URL hostname.

GET/v2/matching-markets/url

Query Parameters

urlstringRequired

Full URL from any supported platform (Polymarket, Kalshi, PredictIt).

Response Schema

successboolean

Whether matching events were found.

countinteger

Number of matching events returned.

eventsobject[]

Matched events with cross-platform market groups.

titlestring

Event name.

event_typestring

Category: economics, sports, election, etc.

event_datestring

Date of the event.

confidencestring

Match confidence: "high" or "medium".

groupsobject[]

Market groups within this event.

titlestring

Group title.

marketsobject[]

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 URL

Platform URLRequired

Response

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