# 📈 ORB 台股開盤區間突破自動監控系統（支援 ntfy 推播） 專案連結：[GitHub - jungkang0911/orb-ntfy](https://github.com/jungkang0911/orb-ntfy) --- ## 💡 專案介紹 這是一個用 Python 撰寫的 **台股 ORB（Opening Range Breakout）監控系統**， 可自動偵測開盤區間突破／跌破，並透過 [ntfy](https://ntfy.sh) 即時推播通知。 > 💬 目標是：讓當沖或策略交易者，在台股開盤時能即時收到「突破訊號」。 --- ## 🚀 系統特色 - 支援多檔台股同時監控（例如：2330.TW、2317.TW、0050.TW）。 - 每天開盤前自動啟動（08:45），收盤後自動關閉（13:40）。 - 可設定突破條件、成交量倍數（`--vol-factor`）。 - 發送通知到自訂的 ntfy 頻道，方便在手機、網頁同步接收。 - 每檔股票只會發一次多頭／空頭訊號，不重複刷屏。 - 附假資料模擬工具 `replay_min.py` 可離線測試。 --- ## 📸 範例通知畫面 ![Sample ntfy alert](https://raw.githubusercontent.com/jungkang0911/orb-ntfy/main/sample_alert.png) ``` ORB 多頭突破 2330.TW LONG @ 795.00 | 2025-10-07 09:22:00 | ORH=790.00 ORL=782.00 VWAP=788.50 ``` --- ## 🧩 安裝與執行 ### 1️⃣ 下載專案 ```bash git clone https://github.com/jungkang0911/orb-ntfy.git cd orb-ntfy ``` ### 2️⃣ 安裝環境 ```bash python3 -m venv venv source venv/bin/activate pip install -r requirements.txt ``` ### 3️⃣ 啟動監控 ```bash python -u orb_multi_yf_ntfy.py \ --symbols 2330.TW,2317.TW,0050.TW \ --open-mins 15 \ --poll-secs 30 \ --vol-factor 1.2 \ --timezone Asia/Taipei \ --ntfy-topic MyStockAlert ``` > 🔔 之後打開網址 > `https://ntfy.sh/MyStockAlert` > 即可即時接收突破通知！ --- ## 🧠 策略邏輯簡介 1. 開盤後前 15 分鐘（09:00–09:15）作為觀察期。 2. 系統計算： - ORH（Opening Range High） - ORL（Opening Range Low） 3. 若價格突破 ORH 且放量 → 發「多頭突破」。 4. 若價格跌破 ORL 且放量 → 發「空頭跌破」。 --- ## 🧪 假資料測試 使用內建模擬器重播假資料，即可模擬盤中突破： ```bash python -u replay_min.py \ --csv data/2330.TW.csv \ --symbol 2330.TW \ --open-mins 15 \ --speed 0.1 \ --vol-factor 0 \ --ntfy-topic MyStockAlert ``` --- ## 🕒 自動排程（可選） 設定 crontab 讓系統自動掛機： ```bash crontab -e ``` 加入： ```bash 45 8 * * 1-5 cd /srv/orb && /srv/orb/venv/bin/python -u /srv/orb/orb_multi_yf_ntfy.py --symbols 2330.TW,2317.TW,0050.TW --open-mins 15 --poll-secs 30 --vol-factor 1.2 --timezone Asia/Taipei --ntfy-topic MyStockAlert > /srv/orb/logs/orb_$(date +\%Y\%m\%d).log 2>&1 & 40 13 * * 1-5 pkill -f orb_multi_yf_ntfy.py ``` 每天自動： - 🕗 08:45 啟動 - 🕓 13:40 收盤結束 --- ## 🧭 未來計畫 - 🔄 接上 **永豐金 Shioaji API**，改為即時報價。 - 💰 整合 Backtrader 進行回測分析。 - 🤖 增加 Telegram / Discord 推播支援。 --- ## 📘 專案連結 👉 [GitHub - jungkang0911/orb-ntfy](https://github.com/jungkang0911/orb-ntfy) --- ## 💬 結語 這是我用 Python 打造的第一個完整自動化盤中監控工具。 如果你也對自動交易或台股策略開發有興趣， 歡迎 Fork、Star ⭐️ 或留言交流 🙌