API reference
API reference
Every v1 endpoint. All are GET under https://api.thepredictionmarkets.com/api/public/v1 and need an X-API-Key header, except /status.
Endpoints
| Endpoint | Returns | Docs |
|---|---|---|
GET /status | API and venue health. No key. | API status |
GET /events | Search and filter events. | List events |
GET /events/{slug} | Every venue's prices for one event. | Event detail |
GET /events/{slug}/history | Candles or snapshots for one outcome. | Price history |
GET /categories | Category slugs and counts. | Categories |
GET /markets | Venue listings. | List markets |
GET /markets/{venue}/{market_id} | One listing with outcomes and rules. | Get one market |
GET /matches | The same market on the other venue. | Matches |
GET /prices | Latest quotes for up to 100 contracts. | Bulk prices |
GET /spreads | Cross-venue price gaps (gross). | Spreads |
GET /rate-limit | Your plan and usage. | Plan and usage |
wss://…/stream | Live quotes (tpm.quotes.v1). | WebSocket guide |
OpenAPI spec and Swagger UI
The same contract is published as an OpenAPI 3 document. Generate a client from it, import it into Postman, or explore it in the browser.
- Open the interactive Swagger UI. Click Authorize and paste your key or the demo key.
- Download the OpenAPI JSON.
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.