# Tradebot Ops

> Operate and monitor the trading bot safely: detect stalls, verify LIVE/halting state, validate data freshness, restart cleanly, and produce human-readable health summaries.

- Skill: `modbender/tradebot-ops` (Agent Skill)
- Install (CLI): `npx skillmds add modbender/tradebot-ops`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/tradebot-ops/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/tradebot-ops

---


# tradebot-ops

## Purpose
Operate and monitor the trading bot safely: detect stalls, verify LIVE/halting state, validate data freshness, restart cleanly, and produce human-readable health summaries.

## Use when
- Bot shows **LIVE** but no updates (stale heartbeat/bars)
- Chart frozen / signals file not updating
- Need to answer: “Is it running? Is it safe? Why no trades?”

## Inputs
- `dist/out/live_heartbeat_*.json`
- `dist/out/live_signals_*.csv`
- `dist/out/live_trades_*.csv` (if present)
- UI endpoints: `/api/trading/*`

## Outputs
- One-paragraph health summary
- If unhealthy: one action (restart/clear stale) + verification
- Audit log entry

## Safety rails
- Never raise `risk_pct` automatically.
- Prefer restart/self-heal over loosening risk.

## Checklist
1) Confirm UI server reachable `/api/status`.
2) Read heartbeat: mode/status/halted/in_position/last_bar_ts.
3) Freshness: `_hb_age_s`, `_bar_age_s`.
4) Confirm signals file mtime is recent.
5) If stale: stop bot PID (runtime or heartbeat pid) → apply+restart.
6) Re-check last_bar_ts advances.