---
title: "X/Twitter Service Health"
method: GET
path: "/x/stocks/v1/health"
tags: ["Health-Check"]
---

# X/Twitter Service Health

`GET /x/stocks/v1/health`

Returns public health and freshness metadata for the X/Twitter 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

- XHealthResponse — X/Twitter service health status - aligned with Reddit health response.
  - `status` string, required — Current health status (healthy/unhealthy)
  - `service` string, required — Service identifier
  - `version` string, required — Current 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` XSchedulerStatus — X Worker scheduler/scraper status (from worker_heartbeat table).
    - `running` boolean, required — Whether worker is alive (heartbeat < 90 min old)
    - `last_scrape` string, nullable — ISO timestamp of last completed scrape cycle
    - `scrape_count` integer — Total completed scrape cycles since worker start
    - `error_count` integer — Total failed scrape cycles
    - `success_rate` number — Success rate (success_count / scrape_count)
    - `note` string, nullable — Additional status info (e.g., worker crash warning)
  - `error` string, nullable — Error message if 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)