Resources
Changelog
What changed, and when. Newest first.
v1.0.1 — 22 October 2026
/events/{slug}/historynow 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./matchesalso returns markets the event page shows as comparable, withmatch_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.
/eventsand/events/{slug}: events grouped across Kalshi and Polymarket, with every outcome's quote and freshness, cross-venue matches and gross gaps./events/{slug}/history: OHLC candles or snapshots, up to 180 days./markets,/matchesand/prices: venue listings, venue-to-venue mapping and bulk quotes./spreads,/categories,/statusand/rate-limit.- Live quotes WebSocket (
tpm.quotes.v1) using thestreamids on every outcome. - One error shape with dotted codes,
X-Request-IDon every response, and rate-limit and quota headers.
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 route | Use 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.
Related
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.