API reference

API status

Is the API up, how many markets does each venue have, and is each live feed healthy? No key needed.

When to use it

Health checks and uptime monitors. It needs no key and does not count against your quota.
Before alerting on old prices: if a venue's live_feed is degraded or down, expect aging quotes from it.

GET/api/public/v1/statusNo key needed

Get API and venue health

Overall status plus, per venue, the number of active markets, the last catalog update and the live feed state.

This endpoint takes no parameters.

Request

curl -s 'https://api.thepredictionmarkets.com/api/public/v1/status'

Response

Example 200 response. Values are illustrative and change over time.

200 OK

{
  "status": "ok",
  "api_version": "v1",
  "server_time": "2026-10-21T08:39:00Z",
  "venues": [
    {
      "venue": "kalshi",
      "active_markets": 4812,
      "last_catalog_update": "2026-10-21T08:24:28Z",
      "live_feed": "ok"
    },
    {
      "venue": "polymarket",
      "active_markets": 7365,
      "last_catalog_update": "2026-10-21T08:37:22Z",
      "live_feed": "ok"
    }
  ]
}

Response fields

Field	Type	Description
status	"ok" \| "degraded"	`degraded` when a venue's data is behind.
api_version	string	Always `v1` on this API.
server_time	string	Server clock (UTC). Handy to check your own clock.
venues[].venue	"kalshi" \| "polymarket"	The venue.
venues[].active_markets	integer	Active markets TPM tracks on it.
venues[].last_catalog_update	string \| null	Last time TPM refreshed the venue's catalog.
venues[].live_feed	string	The venue WebSocket collector: `ok`, `degraded`, `down` or `unknown`.

Errors

HTTP	Code	When
503	upstream.unavailable	Status could not be read. Retry shortly.

503 upstream.unavailable

{
  "error": {
    "code": "upstream.unavailable",
    "message": "Service temporarily unavailable; try again shortly.",
    "request_id": "0f8969a6-0968-4d7c-9cbb-de379e8c19c4"
  }
}

All codes are listed on the errors page.

Try it

Runs a live request from your browser. Pre-filled with the shared demo key (5 requests per second for everyone); paste your own key for steadier results.

Request URL

HTTP: —Time: —Rows: —Remaining this second: —Request: —

Press Send to run this request.

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.

Get a free API key Read the quickstart