# CryptoTradingBot Runtime Runbook

Stand: 2026-06-29

## Grundsatz

Aktiver Betriebsmodus ist `paper_only`.

```text
live_order_allowed=false
mainnet_signed_action=false
Tiny/Normal Live: nicht freigegeben
```

Dieser Runbook beschreibt nur die aktuell erlaubten Paper-/Read-only-Prozesse. Alte monolithische Direkt-Order-Pfade wie `AutoTrader.py` sind Legacy und nicht der Live-Kern.

## Erlaubte Runtime-Prozesse

| Prozess | Zweck | Modus | Delivery |
|---|---|---|---|
| `ctb_v76_paper_supervisor.py` | hält v76 strict/research PaperRuntime am Leben | paper_only | origin |
| `ctb_hl_daily_report.py` | täglicher HyperLiquid Report | read-only/report | origin |
| `ctb_hl_reconcile_watchdog.py` | Reconcile/Kritische Warnungen | read-only/watchdog | origin |
| `crypto_market_context_collect.sh` | Market Context Collector | read-only | local |
| `ctb_research_live_decision_watchdog.py` | Research-to-live Gates, bleibt normalerweise still | read-only/report | origin |
| `ctb_tradingview_paper_bridge_watchdog.py` | TradingView Signale in Paper Bridge | paper_signal only | origin |
| `ctb_tradingview_community_ideas_watchdog.py` | Community Ideas Research | research_only | origin |

## Manuelle Checks

V76 Paper Supervisor Status:

```bash
python3 -m src.tools.v76_paper_supervisor \
  --strategies strict,research_probe \
  --status \
  --json
```

V76 Paper Supervisor sicher starten:

```bash
python3 -m src.tools.v76_paper_supervisor \
  --ensure-running \
  --strategies strict,research_probe \
  --iterations 1440 \
  --interval-seconds 60 \
  --json
```

Daily Report bauen:

```bash
python3 -m src.tools.hyperliquid_daily_report --json
```

Market Confluence Snapshot bauen:

```bash
python3 -m src.tools.market_confluence_report \
  --coins BTC,ETH,SOL,LINK,WLD,SUI,ENA,BCH \
  --json
```

Tests:

```bash
python3 -m pytest -q
```

## Cron Jobs

Aktive relevante Jobs laut Scheduler:

```text
CryptoTradingBot Market Context Collector          every 30m   local
CryptoTradingBot Hyperliquid Tagesbericht 19:00   daily 19:00 origin
CryptoTradingBot Critical Reconcile Watchdog       every 15m   origin
CryptoTradingBot v76 Paper Supervisor              every 30m   origin
CryptoTradingBot Research-to-Live Decision Watchdog every 30m  origin
CTB TradingView Paper Bridge Watchdog              every 5m    origin
CTB TradingView Community Ideas Research Watchdog  every 360m  origin
```

Paused/legacy monitor:

```text
CryptoTradingBot Paper Trading Monitor             paused
```

## Legacy AutoTrader

`AutoTrader.py` and `AutoTrader_backup_2026-03-29_17-30.py` are legacy reference files.

Rules:

```text
Do not use as live core.
Do not start without explicit CTB_ALLOW_LEGACY_AUTOTRADER=true.
Do not use for autonomous trading.
Prefer src/tools/v76_paper_runtime.py and src/tools/v76_paper_supervisor.py.
```

## Promotion / Live Criteria

The bot must remain paper-only until all of the following are true:

```text
true lifecycle PnL positive
winrate above threshold
profit factor above threshold
reconcile clean
exchange-level stop handling verified
loss gates active
kill-switch ready
alerts proven
paper-vs-shadow/confirm phase completed
explicit user approval
```

Current known state:

```text
v76 lifecycle PnL: negative
Promotion: paper_only
Live: nein
```