Quickstart

Set up your environment

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

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.

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.

Sports: ask for spreads and props

The /v2/matching-markets/sports endpoint returns game moneylines only by default. Pass types to add spreads, totals, and player props (or types=all for every class).

curl -H "X-API-Key: $PREDICTION_HUNT_API_KEY" \
  "$PREDICTION_HUNT_API_URL/matching-markets/sports?sport=nfl&types=spread,total,player_prop"

Every group carries market_class (moneyline, spread, total, player_prop, other) and groups from the same game share an event_id, so you can reassemble a game from the flat list.