TradingView Webhook 設定教學
一步一步帶你把 TradingView 警報連接到 4pass 自動交易系統，讓交易策略 24/7 自動執行。
概述
什麼是 Webhook？
Webhook 就像是一個「通知網址」。當 TradingView 上你的策略觸發警報時，它會自動發送訊息到這個網址，告訴我們的系統：「嘿！現在要下單了！」
TradingView
交易策略平台你的策略在這裡運行，當條件滿足時產生買進/賣出訊號
4pass 系統
自動交易引擎收到訊號後，立即透過您設定的券商 API 自動下單
事前準備
TradingView 付費方案
Webhook 功能需要付費版才能使用（Essential、Plus、Premium、Ultimate 皆可）
4pass 帳號
已註冊並設定好券商 API 憑證
你自己的交易策略
本教學不提供策略，只教你如何連接。策略請自行開發或使用現有的
重要提醒
本文件僅教學 Webhook 技術串接，不提供任何交易策略或投資建議。交易有高度風險，可能損失全部本金。請確保你了解相關風險，並只用你能承受損失的資金進行交易。
安全性警告：請務必設定 IP 白名單
你的 Webhook URL 包含專屬的 Token，等同於你的「下單密碼」。如果 URL 外洩且未設定 IP 白名單，任何人都可以用這個網址對你的帳戶下單！
強烈建議：
- 前往 4pass 系統的「安全設定」頁面，設定 IP 白名單
- 只允許 TradingView 的 IP 位址（系統會提供建議的 IP 清單）
- 不要在公開場合（如社群、論壇）分享你的 Webhook URL
取得你的 Webhook URL
首先，我們要從 4pass 系統取得你專屬的 Webhook URL。這個網址是獨一無二的，只有你能使用。
操作步驟：
- 1 登入 4pass 系統（點右上角「登入系統」）
- 2 進入「Webhook 設定」頁面
- 3 你會看到你的專屬 Webhook URL，長得像這樣：
/webhook/你的專屬Token/order?simulation=true
小提示：URL 最後的 simulation=true 代表模擬交易模式，不會真的下單。確認一切正常後再改成 simulation=false
/webhook/abc123xyz.../order
點擊「複製」按鈕取得你的 Webhook URL
開啟 TradingView 圖表
現在，讓我們到 TradingView 進行設定。
操作步驟：
- 1 前往 tradingview.com 並登入你的帳號
- 2 點擊上方的「圖表」或「Chart」進入圖表介面
-
3
在左上角搜尋框輸入你要交易的商品代碼（例如：
TX1!）
搜尋你要交易的商品代碼，然後點擊 Create Alert
將策略加入圖表
接下來要把你的交易策略加到圖表上。
操作步驟：
-
1
點擊上方工具列的「指標」按鈕（或按快捷鍵
/） - 2 搜尋你的策略名稱，或選擇「我的腳本」找到你儲存的策略
- 3 點擊策略名稱將它加入圖表
策略腳本要求
你的 PineScript 策略必須在 strategy.entry() 和 strategy.close() 中加入 alert_message 參數，格式如下：
strategy.entry("多單", strategy.long, alert_message="long_entry")
strategy.close("多單", alert_message="long_exit")
strategy.entry("空單", strategy.short, alert_message="short_entry")
strategy.close("空單", alert_message="short_exit")點擊你的策略將它加入圖表
建立警報
策略加好之後，我們要建立警報。這樣當策略觸發訊號時，TradingView 才會通知我們的系統。
操作步驟：
- 1 在圖表上右鍵點擊你的策略名稱
- 2 選擇「在...上新增警示」或「Add Alert on...」
- 3 在「條件」欄位，確認選擇的是你的策略，觸發條件選「Order fills only」（只在成交時觸發）
小提示：你也可以點擊右側面板的「鬧鐘」圖示 ，然後點「+」來建立新警報
選擇 Order fills only（只在成交時觸發）
設定 Webhook
這是最重要的一步！我們要把 Webhook URL 填進去，並設定正確的訊息格式。
操作步驟：
- 1 在警報設定視窗中，找到「通知」區塊
- 2 勾選「Webhook URL」選項
- 3 貼上你在步驟 1 取得的 Webhook URL
- 4 在「訊息」欄位，填入以下 JSON 格式（這很重要！）：
模擬模式 simulation=true
{
"action": "{{strategy.order.alert_message}}",
"symbol": "YOUR_SYMBOL",
"quantity": {{strategy.order.contracts}}
}正式交易 simulation=false（需要 timestamp 和 secret）
{
"action": "{{strategy.order.alert_message}}",
"symbol": "YOUR_SYMBOL",
"quantity": {{strategy.order.contracts}},
"timestamp": "{{timenow}}",
"secret": "你的Webhook Secret"
}參數說明
action- 動作類型（由策略自動帶入）symbol- 商品代碼（請在 4pass「商品代碼」頁面查看支援的代碼）quantity- 下單口數（由策略帶入）timestamp- 時間戳（正式交易必填，使用{{timenow}}）secret- Webhook Secret（正式交易必填，從 4pass 設定頁面取得）
商品代碼
symbol 請填入您在 4pass 系統中使用的商品代碼。
可在儀表板的「商品代碼」頁面查看完整的支援清單。
正式交易安全機制
當使用 simulation=false 進行正式交易時，必須提供：
-
timestamp - 使用 TradingView 的
{{timenow}}變數，系統會驗證請求是否在 5 分鐘內 - secret - 你的 Webhook Secret，可在 4pass 系統的 Webhook 設定頁面取得
這些機制可防止重放攻擊和 URL 外洩風險
注意：JSON 格式必須完全正確，包含大括號、引號、逗號。建議直接複製上方的程式碼
"action": "{{strategy.order.alert_message}}",
"symbol": "YOUR_SYMBOL",
"quantity": {{strategy.order.contracts}},
"timestamp": "{{timenow}}",
"secret": "你的Webhook Secret"
}
貼上 Webhook URL 和 JSON 訊息內容（正式交易需包含 timestamp 和 secret）
最後設定：
- 5 「警報名稱」填一個好記的名字，例如「4pass 自動交易」
- 6 「到期時間」選擇「開放式警報」（永不過期）
- 7 點擊「建立」按鈕
測試警報
設定完成！現在讓我們測試一下確保一切正常運作。
測試方式：
-
1
確保 Webhook URL 中
simulation=true（模擬模式） - 2 回到 4pass 系統的「訂單紀錄」頁面
- 3 等待你的策略觸發警報（或手動在 TradingView 上觸發測試）
- 4 檢查訂單紀錄，應該會看到新的模擬訂單
測試成功的標準
- ✓ 訂單紀錄出現新的項目
- ✓ 動作（Action）正確顯示 long_entry/long_exit 等
- ✓ 商品代碼和口數正確
- ✓ 狀態顯示「模擬」而非「實盤」
| 時間 | 動作 | 商品 | 口數 | 狀態 |
|---|---|---|---|---|
| 14:32:15 | long_entry | YOUR_SYMBOL | 1 | 模擬 |
| 13:15:42 | long_exit | YOUR_SYMBOL | 1 | 模擬 |
| 11:08:33 | long_entry | YOUR_SYMBOL | 1 | 模擬 |
看到「模擬」標籤表示測試成功！
準備好實盤交易了嗎？
確認模擬交易一切正常後，依照以下步驟切換至正式交易：
- 1. 將 Webhook URL 的
simulation=true改為simulation=false - 2. 在訊息 JSON 加入
"timestamp": "{{timenow}}" - 3. 在訊息 JSON 加入
"secret": "你的Secret"（從 4pass 設定頁取得）
請謹慎操作，實盤交易會使用真實資金！
常見問題
警報觸發了但訂單沒出現？
- 確認 Webhook URL 是否正確（包含你的 Token）
- 檢查 JSON 訊息格式是否正確（特別是引號和逗號）
- 確認你的 4pass 帳號訂閱仍然有效
- 查看 4pass 的「系統日誌」是否有錯誤訊息
TradingView 說「無法傳送 Webhook」？
- 確認你的 TradingView 是付費方案（Essential / Plus / Premium / Ultimate）
- 檢查 URL 是否以 https:// 開頭
- 確認網址沒有多餘的空格或換行
- 嘗試重新建立警報
訂單顯示「action 無效」？
action 必須是以下四種之一：
long_entry- 做多進場long_exit- 做多出場short_entry- 做空進場short_exit- 做空出場
請檢查你的策略腳本中 alert_message 的值是否正確。
如何更換 Webhook Token？
如果你擔心 Token 外洩，可以在 4pass 系統的「Webhook 設定」頁面點擊「重新產生 Token」。記得同時更新 TradingView 中的 Webhook URL。
Webhook URL 外洩了怎麼辦？
這是嚴重的安全事件！如果你的 Webhook URL 外洩，攻擊者可能會：
- 偽造交易訊號，讓你的帳戶下非預期的單
- 大量發送惡意請求，造成帳戶異常
- 在不利的價位強制你進出場
緊急處理步驟：
- 立即到 4pass 系統重新產生 Token（舊的會立即失效）
- 設定 IP 白名單，只允許 TradingView 的 IP
- 更新 TradingView 警報中的 Webhook URL
- 檢查訂單紀錄是否有異常交易
預防勝於治療：即使 URL 未外洩，也強烈建議現在就去設定 IP 白名單！