alpha-strike

English | 日本語

AlphaForge 戦略（Pine v6 Webhook エクスポート）とペアで使う発注ブリッジ — TradingView のアラートを Webhook で受け取り、moomoo / OANDA に自動発注するセルフホスト型サーバーです。戦略の作成・最適化・ウォークフォワード検証は AlphaForge で。→ AlphaForge を無料で試す

TradingView のアラートを Webhook で受け取り、moomoo / OANDA に自動発注するセルフホスト型ブリッジ

alpha-strike は、TradingView Premium / Essential 以上のアラート機能から Webhook 経由でシグナルを受け取り、リクエストボディに基づいて moomoo 証券（米国株・香港株・暗号資産） または OANDA 証券（FX・CFD） へ自動発注する FastAPI ベースの Webhook サーバーです。

Oracle Cloud Always Free + Cloudflare Tunnel + Cloudflare WAF Custom Rule の構成で、自宅 IP の DHCP 変動に依存せず、月額 0 円でセルフホストできるリファレンス実装も提供しています。

TradingView Premium / Essential
       │  HTTPS Webhook
       ▼
Cloudflare WAF Custom Rule (TradingView IP allowlist)
       │
Cloudflare Tunnel (cloudflared)
       │  outbound only (NSG Ingress = 0)
       ▼
alpha-strike (FastAPI, this repo)
       │
       ├──► moomoo OpenD ─► moomoo SIMULATE / REAL (米国株 / 香港株 / 暗号資産)
       └──► OANDA REST v20 ─► OANDA PRACTICE / LIVE (FX / CFD)

主な機能

• TradingView Webhook 受信 — /webhook エンドポイントで JSON ペイロードを受理、Pydantic で厳格バリデーション
• passphrase 認証 — リクエストボディの passphrase を WEBHOOK_PASSPHRASE と HMAC 比較
• multi-broker ルーティング — broker: "moomoo" | "oanda" で発注先を選択。asset_class で US / HK / CRYPTO / FX / COMMODITY / INDEX を切替
• Rate limiting — slowapi で 10 req/min/IP の上限を強制
• リトライ + タイムアウト — tenacity で broker API 一時障害に対する自動リトライ（OANDA: 指数バックオフ ×3、moomoo: 固定 2 秒 ×3）
• JSONL イベントログ — SignalEvent / OrderEvent / FillEvent / TradeClosedEvent を逐次追記、journal との pnl 突合に利用可
• メモリ・サービス監視 — scripts/check_memory.sh を cron 登録すれば 5 分毎にメモリ・swap・サービス・OOM を ntfy 通知
• 本格運用向けデプロイ手順 — 初回構築は docs/ops/vm-provisioning.md（Oracle Cloud E2.1.Micro + Cloudflare Tunnel + systemd）、新バージョンの反映（PyPI → VM 更新 + 再起動）は docs/ops/deployment.md を参照

クイックスタート

ローカルで試す（最短）

PyPI から（推奨）

# uv（推奨）
uv add alpha-strike

# または pipx でグローバル CLI として
pipx install alpha-strike

# または venv に直接
pip install alpha-strike

起動:

WEBHOOK_PASSPHRASE=your-secret-passphrase alpha-strike

# ホスト / ポート指定
WEBHOOK_PASSPHRASE=your-secret-passphrase alpha-strike --host 127.0.0.1 --port 9000

# 疎通確認
curl http://localhost:8080/health
# → {"status":"ok"}

ソースから（開発時）

git clone https://github.com/alforge-labs/alpha-strike.git
cd alpha-strike
uv sync

# .env を設定
echo 'WEBHOOK_PASSPHRASE=your-secret-passphrase' > .env
echo 'MOOMOO_TRD_ENV=SIMULATE' >> .env  # moomoo を使う場合
echo 'OANDA_ENV=PRACTICE'     >> .env   # OANDA を使う場合

# CLI から起動
uv run alpha-strike

# ホットリロード（開発時）
uv run alpha-strike --reload

Oracle Cloud + Cloudflare Tunnel で本格運用

ペーパートレード本格運用までの完全手順は公式ドキュメントを参照：

• 📖 alpha-strike セットアップガイド — VM プロビジョニング・Cloudflare Tunnel・WAF・OpenD・systemd の全手順
• 📖 TradingView × alpha-strike Integration — Webhook ペイロード仕様と Pine v6 テンプレート

環境変数

重要: 検証時は必ず MOOMOO_TRD_ENV=SIMULATE / OANDA_ENV=PRACTICE を使用してください。本番口座での誤発注は本ソフトウェアの責任範囲外です。

Webhook ペイロード仕様

詳細は docs/tradingview.md と docs/webhook-payload-v2.md を参照。最小例：

{
  "passphrase": "your-secret-passphrase",
  "broker": "moomoo",
  "asset_class": "US",
  "action": "buy",
  "ticker": "US.AAPL",
  "quantity": 10,
  "run_mode": "paper",
  "strategy_id": "demo_buy_v1"
}

任意フィールド target_qty（目標絶対保有量、>= 0）を付けると、moomoo では broker 実保有との差分から発注数量・方向を再解決する（closed-loop、#80）。quantity は target_qty 非対応バージョン向けのフォールバック値（増減量）として併送する。

ライブ実績の可視化

alpha-strike が記録するイベントログ（JSONL）は、AlphaForge で取り込み、alpha-visualizer（OSS・Apache-2.0）の Live 画面でエクイティカーブとして可視化できます。バックテスト結果との乖離（diff）も同じ画面で確認できます。

# 1. VM 上のイベント JSONL をローカルの forge プロジェクトへ同期
alpha-forge live sync-events

# 2. イベントを取り込んでライブ実績を生成
alpha-forge live import-events <strategy_id>          # 戦略単位
alpha-forge live replay <portfolio_id> \
  --combine-strategies <id1>,<id2>                    # combine ポートフォリオ

# 3. alpha-visualizer の Live 画面で表示
pip install alpha-visualizer
alpha-vis serve

ドキュメント

• 📖 公式ドキュメント — Alforge Labs ドキュメント集約
• 📖 alpha-strike セットアップガイド — 本格運用までの完全手順
• 📖 Webhook ペイロード仕様 — JSON フィールドの詳細
• 📖 VM プロビジョニング手順書 — Oracle Cloud E2.1.Micro + Cloudflare Tunnel
• 📖 ペーパートレード Go-Live チェックリスト — 本番運用前の確認項目
• 📖 moomoo OpenD セットアップ — OpenD CLI インストールとデバイストークン認証

開発に参加する

• コントリビューションガイド: CONTRIBUTING.md
• セキュリティ報告: SECURITY.md
• 行動規範: CODE_OF_CONDUCT.md（Contributor Covenant v2.1）
• 変更履歴: CHANGELOG.md

開発環境

# 依存関係インストール
uv sync

# テスト + Lint
uv run pytest tests/ -q
uv run ruff check .

# PyPI 配布用 wheel / sdist をローカル生成
uv build
# → dist/alpha_strike-X.Y.Z-py3-none-any.whl + .tar.gz

関連プロジェクト

• 🌐 alforgelabs.com — Alforge Labs 公式サイト
• 📊 alpha-visualizer — AlphaForge バックテスト結果と alpha-strike ライブ実績の Web 可視化ツール（Apache-2.0）
• 🧪 AlphaForge — バックテスト・最適化エンジン（商用ライセンス）

免責事項

本ソフトウェアは現状のまま（AS IS）提供され、いかなる種類の保証もありません。自動売買は元本を超える損失を生じる可能性があります。本ソフトウェアを利用して発生した直接・間接の損害（金銭的損失を含む）について、著作権者およびコントリビューターは一切の責任を負いません。本ソフトウェアの利用は完全に自己責任で行ってください。

各 broker の利用規約・取引時間・規制を必ず遵守してください。米国居住者の moomoo crypto 利用には FinCEN MSB 規制が適用される等、規制要件は利用者自身で確認・遵守する責任があります。

ライセンス

Apache License 2.0 © alforge-labs