---
# System prepended metadata

title: "\U0001F4C8 ORB 台股開盤區間突破自動監控系統（支援 ntfy 推播）"

---

# 📈 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 ⭐️ 或留言交流 🙌
