Pipeline

Health of every scheduled cron job. Green = ran recently within cadence · Amber = slightly stale · Red = dormant, failed, or never instrumented. Deploy is not 'done' until this page is fully green.

Total jobs

from /api/cron/* routes

✅ Healthy

11 / 22

ran within cadence

⚠ Stale

ran but past cadence

🛑 Broken

never ran, failed, or very stale

Cron job health

Heartbeats written to kv_store by the withCronHeartbeat wrapper around each route. Page revalidates every 30s.

Job	Source	Schedule	Last run	Duration	Detail
HYPE whales (Dashboard cache) snapshot-hype-whales ↗ /api/cron/snapshot-hype-whales	HLHypurrscan	every 2h :06	2026-05-21 15:02:52 UTC	1ms	last run failed (HTTP 401)
Unstaking queue (14d) snapshot-unstaking-queue-recent ↗ /api/cron/snapshot-unstaking-queue-recent	Hypurrscan	every 30 min :05,:35	2026-05-21 15:35:00 UTC	552ms	last run failed (HTTP 500)
TWAPs hourly snapshot-twaps ↗ /api/cron/snapshot-twaps	Hypurrscan	hourly :07	2026-05-21 15:02:58 UTC	0ms	last run failed (HTTP 401)
HIP-3 markets snapshot-hip3-markets ↗ /api/cron/snapshot-hip3-markets	HL	hourly :10	2026-05-21 15:02:58 UTC	0ms	last run failed (HTTP 401)
Wallet state (Positions page) snapshot-wallet-state ↗ /api/cron/snapshot-wallet-state	HL	every 4h	2026-05-21 15:02:51 UTC	1ms	last run failed (HTTP 401)
HIP-3 daily snapshot snapshot-hip3 ↗ /api/cron/snapshot-hip3	HL	daily 00:05	2026-05-21 15:03:00 UTC	0ms	last run failed (HTTP 401)
Staking snapshot snapshot-staking ↗ /api/cron/snapshot-staking	HL	daily 00:30	2026-05-21 15:03:04 UTC	0ms	last run failed (HTTP 401)
Team wallet transfers snapshot-team-distributions ↗ /api/cron/snapshot-team-distributions	Hypurrscan	daily 00:45	2026-05-21 15:02:50 UTC	0ms	last run failed (HTTP 401)
Unstaking history (full) snapshot-unstaking-queue-full ↗ /api/cron/snapshot-unstaking-queue-full	Hypurrscan	daily 01:00	2026-05-21 15:02:47 UTC	0ms	last run failed (HTTP 401)
Hyperdash wallet labels snapshot-hyperdash-labels ↗ /api/cron/snapshot-hyperdash-labels	Hyperdash	Weekly Mon 04:00 UTC	2026-05-21 15:03:02 UTC	0ms	last run failed (HTTP 401)
Hyperdash cohort positioning snapshot-hyperdash-positioning ↗ /api/cron/snapshot-hyperdash-positioning	Hyperdash	Every 2h :00	2026-05-21 15:02:47 UTC	1ms	last run failed (HTTP 401)
Telegram poll telegram-poll ↗ /api/cron/telegram-poll	Telegram	every 30s	2026-05-21 15:35:00 UTC	305ms	last ok 13s ago
HYPE trades indexer snapshot-hype-trades ↗ /api/cron/snapshot-hype-trades	HL	every 10 min :00,:10…	2026-05-21 15:30:48 UTC	48707ms	last ok 4m ago
Perp trades indexer snapshot-perp-trades ↗ /api/cron/snapshot-perp-trades/HYPE	HL	every 10 min :02,:12…	2026-05-21 15:32:50 UTC	50481ms	last ok 2m ago
Coinalyze flow cache snapshot-coinalyze-flow ↗ /api/cron/snapshot-coinalyze-flow	Coinalyze	every 5 min :03,:08…	2026-05-21 15:33:00 UTC	799ms	last ok 2m ago
HYPE transfers (90D cache) snapshot-hype-transfers ↗ /api/cron/snapshot-hype-transfers	HypurrscanHL	every 5 min :04,:09…	2026-05-21 15:34:00 UTC	9ms	last ok 1m ago
Smart Money fills snapshot-smart-money ↗ /api/cron/snapshot-smart-money	HL	every 30 min :00,:30	2026-05-21 15:30:16 UTC	15909ms	last ok 5m ago
Kinetiq fees snapshot-km-fees ↗ /api/cron/snapshot-km-fees	Kinetiq	hourly :15	2026-05-21 15:15:00 UTC	37ms	last ok 20m ago
Kinetiq volume snapshot-km-volume ↗ /api/cron/snapshot-km-volume	HL	hourly :20	2026-05-21 15:20:00 UTC	3ms	last ok 15m ago
Kinetiq buybacks snapshot-kntq-buybacks ↗ /api/cron/snapshot-kntq-buybacks	Etherscan	hourly :25	2026-05-21 15:25:00 UTC	20ms	last ok 10m ago
Signal alerts (Telegram) check-signals ↗ /api/cron/check-signals	internalTelegram	daily 00:10	2026-05-21 15:11:20 UTC	200ms	last ok 24m ago
Hyperdash market participation snapshot-hyperdash-market-participation ↗ /api/cron/snapshot-hyperdash-market-participation	Hyperdash	Every 2h :15	2026-05-21 15:15:00 UTC	548ms	last ok 20m ago

If a row is red

Never ran: the ofelia label exists but no successful fire has been recorded. Likely causes: container hasn't been recreated since deploy (labels not picked up), $CRON_SECRET missing inside container, or wget command 404'd (URL mismatch).
Fix:

sudo docker compose up -d --force-recreate hyperforge cron
sudo docker logs hyperforge-cron --tail 40 | grep -iE "register|error|401"

Failed (HTTP 4xx/5xx): the cron fires but the route returns an error. The error message is shown in the Detail column. 401 = auth (re-check $CRON_SECRET parity). 500 = upstream API or DB issue — check container logs.

Stale > 3× cadence:the cron used to work but has stopped. Either ofelia died, the host clock is wrong, or the route now throws unhandled. Same diagnosis as "never ran".

Page logic: readCronHeartbeat() in src/lib/cron-heartbeat.ts. Cron name list is hardcoded in src/app/docs/pipeline/page.tsx — keep it in sync with docker-compose.yml ofelia labels. The npm run audit:crons script enforces that every route in src/app/api/cron/* has a corresponding ofelia schedule.

Dashboard