Quickstart

From zero to your first live prediction market data in under 2 minutes. No SDK required — just HTTP.

Get your API key

Free keys are generated instantly. Click Get Free API Access on the docs landing page. Your key is prefixed with pmx_:

your api key

text

pmx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Set up your environment

Store your key in an environment variable — never hardcode it in source.

.envshell

PREDICTION_HUNT_API_KEY=your_api_key_here
PREDICTION_HUNT_API_URL=https://www.predictionhunt.com/api/v2

Fetch active prediction market events

The /v2/events endpoint returns live events matched across all platforms — Kalshi, Polymarket, PredictIt, ProphetX, and Opinion.

curlpythonjavascript

curl -H "X-API-Key: $PREDICTION_HUNT_API_KEY" \
  "$PREDICTION_HUNT_API_URL/events?limit=5"

Explore the response

Each event is cross-platform matched. group_count tells you how many platforms carry the same market. Paginate with next_cursor.

GET /v2/events?limit=5 — 200 OK200 OK

{

"events": [

{

"id": "evt_pres_2028",

"event_name": "2028 Presidential Election Winner",

"event_type": "politics",

"event_date": "2028-11-07",

"status": "active",

"group_count": 5,

"platforms": ["kalshi", "polymarket", "predictit"]

}

{ ... }

"next_cursor": "eyJpZCI6MTIzfQ==",

"total_count": 1847

}

Fetch OHLC candlestick data for charting, search for cross-platform matches, or stream arbitrage signals.

OHLC candle data for any market at configurable intervals.

Browse all active markets with current prices across platforms.

Find the same event traded on Kalshi, Polymarket, PredictIt and more.

Live arbitrage opportunities across all matched platforms. Dev/Pro only.