Quickstart

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

Get your API key

Create a free key or copy your existing key below. Store it securely and send it with each request.

Make your first request

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://prediction.com/api/v2

Existing integrations using https://www.predictionhunt.com/api/v2 remain supported with the same API keys and authentication.

Fetch active prediction market events

The /v2/events endpoint returns live events matched across all platforms - Kalshi, Polymarket, Polymarket US, PredictIt, ProphetX, Opinion, Predict.fun, and Novig.

curlpythonjavascript

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

Explore the response

Each event includes groups by default. Each group's platform_count tells you how many platforms carry that market. Paginate with next_cursor.

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

{

"events": [

{

"id": 123,

"event_name": "2028 Presidential Election Winner",

"event_type": "politics",

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

"status": "active",

"groups": [{

"group_id": 456, "title": "Election winner",

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

"market_class": null, "market_type": null

}]

}

"next_cursor": "eyJpZCI6MTIzfQ==",

"total_count": 1847

}

Try more endpoints

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

Price History

/v2/prices/history

OHLC candle data for any market at configurable intervals.

Markets

/v2/markets

Browse all active markets with current prices across platforms.

Cross-Platform Matches

/v2/matching-markets

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

Arbitrage Signals

/v2/arb

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

Ready to put it together? Follow our step-by-step guide to building a Polymarket trading bot in Python.