v1

latestOpenAPI 3.1.0MIT2026-08-0453113564.4 KB

Health-Check

Polymarket Service Health

Returns public health and freshness metadata for the Polymarket stocks platform.

Use it to check service availability, ingestion freshness and worker liveness. Client integrations usually start with /trending, /stock/{ticker} or /search.

get/polymarket/stocks/v1/health

Response

Successful Response

statusstring required

Current health status

servicestring required

Service identifier

versionstring required

API version

total_mentionsinteger required

Mentions observed in the most recent scrape cycle; returns 0 when scrape telemetry is unavailable.

tickers_trackedinteger required

Distinct tickers observed in the most recent scrape cycle; returns 0 when scrape telemetry is unavailable.

errorstring nullable

Error message when unhealthy

Example response

{
  "status": "healthy",
  "service": "polymarket-stocks",
  "version": "1.49.0",
  "total_mentions": 8421,
  "tickers_tracked": 119,
  "scheduler": {
    "running": true,
    "last_scrape": "2026-02-18T10:00:00Z",
    "scrape_count": 58,
    "error_count": 1,
    "success_rate": 0.983
  }
}