The Prediction Markets
Resources

Changelog

What changed, and when. Newest first.

v1.0.1 — 22 October 2026

  • /events/{slug}/history now returns history for every outcome. Where TPM doesn't stream a market, points come from the venue's own price history (source: "venue_history", or "mixed" when streamed candles start partway through). Outcomes from comparable events shown on the event page work too.
  • /matches also returns markets the event page shows as comparable, with match_state: "COMPARABLE". Only the titles match, so check the settlement rules.
  • History timestamps end in Z, like every other time in the API.

v1.0.0 — 21 October 2026

Initial release of the stable public API at /api/public/v1.

Coming from the old /api/v2 docs

Earlier versions of these docs described /api/v2 routes. Those are the website's own internal API: they can change without notice and are no longer documented. Move to v1:

Old routeUse instead
/api/v2/events/api/public/v1/events
/api/v2/events/{slug}/api/public/v1/events/{slug}
/api/v2/spreads, /api/v2/spreads/top/api/public/v1/spreads
Polymarket and Kalshi markets and events/api/public/v1/markets?venue=…
Polymarket and Kalshi prices/api/public/v1/prices
Candlesticks and price history/api/public/v1/events/{slug}/history

Versioning policy

  • v1 only grows. We may add endpoints, optional parameters, response fields and error codes. Write clients that ignore unknown fields.
  • We never rename or remove a v1 field or endpoint, or change its type or meaning.
  • A breaking change would ship as /api/public/v2, announced here in advance, with v1 kept running during the move.

Build with TPM

Get your free API key

One key gives you Kalshi and Polymarket events, prices with freshness, price history, cross-venue gaps and the live quotes WebSocket.