## 概要
検証#1-10で発見・確定したすべてを統合した**ペーパートレード（仮想売買）bot**。実弾は流さない（取引所API未接続）。フォワードテストの土台。

## 安全設計（最重要）
- **取引所API未接続＝実弾ゼロ**。発注は仮想約定（JSON記録）のみ
- 理由: フォワードテスト未実施・APIキーは本物資金に直結・「バックテストで勝てても本番で負ける」鉄則
- これは「botが正しく動くか」を実弾リスクなしで検証する段階

## 統合した要素
| 由来 | 要素 |
|------|------|
| 検証#8 | 市場別最適エントリー（USDJPY=ma_cross/GC=donchian/CL=rsi_rev/SPY=donchian/AAPL=breakout/BTC=donchian） |
| 検証#9 | 200SMAトレンドフィルタ・ATR×2ストップ・RR2.5(プラトー中央) |
| 検証#10 | 1トレードのリスク=資金の3%（ATRストップ幅から逆算ロット） |
| Opus4.8推奨 | 状態を外部JSON(paper_state.json)保存・ロングラン対応 |

## 動作
```bash
python paper_bot.py # 1ティック: 全市場シグナル評価→TP/SL判定→仮想エントリー→状態更新
python paper_bot.py --status # 仮想ポートフォリオ状態表示
```
毎ティック: ①最新データ取得 ②保有ポジのTP/SL判定→仮想クローズ ③新規シグナル→3%ロット計算→仮想エントリー ④JSON保存

## 動作検証（実データ）
- **ロジック生存確認**: 各市場で過去シグナル176-957回発生（USDJPY176/GC891/CL423/SPY469/AAPL569/BTC957）、直近もGC/SPY/AAPLは6本前に発生＝正常稼働
- **3%サイジング検証**: SPYシグナル足(2026-05-29)で価格756.60・ATR1.94 → lot7740 → **SL到達時の最大損失29,997円＝資金の正確に3.0%** ✅
- 状態JSON保存・--status表示ともに正常

## 次段階（フォワードテスト）
- このbotを定期実行（cron/PM2）して数ヶ月間の仮想成績を蓄積 → 未来データで本当に勝つか検証
- 仮想で安定プラスを確認できたら初めて少額実弾を検討（それまで実弾は流さない）
- 注意: yfinance 1時間足は遅延あり・リアルタイム性は限定的 → 本番運用には別データソース要

## 関連
- LLM Wiki id=447,448(エッジ), id=449(ダッシュボード), id=451(資金管理)
- コード: /home/ubuntu/workspace/trade-backtest/paper_bot.py / 状態: paper_state.json