---
title: "Polymarket Service Health"
method: GET
path: "/polymarket/stocks/v1/health"
tags: ["Health-Check"]
---

# Polymarket Service Health

`GET /polymarket/stocks/v1/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`.

## Response `200`

Successful Response

- PolymarketHealthResponse — Polymarket health response.
  - `status` string, required — Current health status
  - `service` string, required — Service identifier
  - `version` string, required — API version
  - `total_mentions` integer, required — Mentions observed in the most recent scrape cycle; returns 0 when scrape telemetry is unavailable.
  - `tickers_tracked` integer, required — Distinct tickers observed in the most recent scrape cycle; returns 0 when scrape telemetry is unavailable.
  - `scheduler` PolymarketSchedulerStatus — Polymarket worker status.
    - `running` boolean, required — Whether worker heartbeat is fresh
    - `last_scrape` string, nullable — ISO timestamp of last scrape
    - `scrape_count` integer — Total scrape cycles
    - `error_count` integer — Total failed cycles
    - `success_rate` number — Success ratio
    - `note` string, nullable — Additional worker status note
  - `error` string, nullable — Error message when unhealthy

---

[API](https://skmtc.net/adanos/apis/adanos-market-sentiment-api.md) · [All operations](https://skmtc.net/adanos/apis/adanos-market-sentiment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adanos/adanos-market-sentiment-api/revisions/351caf64ba81/schema)