
重點整理
- TradingView 官方說明寫明:快訊(alert)不是為自動交易設計的,策略也只能在回測模式執行。Webhook 做的事,是快訊觸發時把訊息用 HTTP POST 送到你指定的網址;要下單,得自己架接收端,再接到期貨商提供的下單程式。
- 官方送出規格:只送往 80、443 埠,接收端要在 3 秒內回應,不支援 IPv6,帳號要開兩步驟驗證;送出的 IP 固定 4 個,可以拿來設白名單。
- 接收端回 500~599(504 除外)時,TradingView 隔 5 秒重送,最多重送 3 次,一次觸發最多收到 4 筆同樣的訊息。
- 防重複下單靠兩層:接收端用冪等鍵擋掉同一次觸發的重送;下單前拿策略的目標部位跟帳戶實際部位對帳,只送差額。
- 策略快訊只在即時 K 棒上有成交時發出,3 分鐘內觸發超過 15 次會被停掉;改了圖上的策略設定,要刪掉快訊重建才會生效。
一、Webhook 是什麼:快訊觸發後送出一筆 HTTP POST
Webhook 是「事情發生時,由對方主動打你的網址」的通知方式。TradingView 的快訊在它自己的伺服器上執行,關掉瀏覽器也照常觸發;觸發時,把快訊訊息放在 POST 請求的內容(body)裡送出。
從快訊到成交中間有三段,每段要防的事不同。
| 段落 | 誰負責 | 要防的事 |
|---|---|---|
| 快訊觸發、送出 | TradingView 伺服器 | 訊號重繪、快訊被停用或到期 |
| 接收端 | 自己架的伺服器 | 冒名請求、重送造成重複、3 秒逾時 |
| 下單程式 | 自己的程式+期貨商 API | 斷線、送出不等於成交、部位對不上 |
- 建立策略快訊時,TradingView 會在伺服器上複製一份策略獨立執行。之後改圖上的參數,伺服器那份不會跟著改,要刪掉快訊重建。
- 期貨商 API 怎麼登入、怎麼送單,各家規定不同,以各家官方文件為準。
小結:TradingView 負責把訊息送出去,接收、判斷、下單、對帳都在自己這一端。
二、官方送出規格:IP、連接埠與 3 秒逾時
| 項目 | TradingView 官方規定 |
|---|---|
| 送出的 IP | 52.89.214.238、34.212.75.30、54.218.53.128、52.32.178.7 |
| 連接埠 | 只接受 80、443,其他埠會被拒絕 |
| 回應時間 | 接收端超過 3 秒沒處理完,請求取消 |
| 網路 | 不支援 IPv6;網址解析到本機或內部 IP 會被擋 |
| 帳號 | 開了兩步驟驗證才能用 Webhook |
| 格式 | 訊息是合法 JSON 就帶 application/json,否則帶 text/plain |
| 驗證來源 | 走 HTTPS 時會附憑證,欄位 CN 是 webhook-server@tradingview.com |
- 官方另外提醒:帳號、密碼這類登入資料不要放在網址或訊息裡。
- 每一次送出的結果,在快訊紀錄(alert log)的「Webhook status」欄看得到。
例題:假設接收端收到訊息後,同步等期貨商回覆委託結果才回應,送單加回報花了 4 秒。TradingView 在第 3 秒取消請求,快訊紀錄記成逾時,那筆單卻已經送出去了。所以接收端要先回應再處理:收到就回 200,把訊息放進佇列,下單程式另外處理。
小結:接收端只做三件事:檢查來源、檢查有沒有收過、放進佇列,然後馬上回應。
三、訊息格式:用 JSON 和佔位符帶出訂單內容
快訊訊息裡可以放佔位符(placeholder),觸發時換成實際的值。策略快訊常用這幾個佔位符。
| 佔位符 | 觸發時換成 |
|---|---|
| {{ticker}} | 商品代號 |
| {{time}} | 觸發那根 K 棒的時間(UTC) |
| {{timenow}} | 快訊觸發的時間(UTC,到秒) |
| {{strategy.order.id}} | 成交那筆委託的 ID(strategy.entry 的第一個參數) |
| {{strategy.order.action}} | buy 或 sell |
| {{strategy.order.contracts}} | 成交口數 |
| {{strategy.position_size}} | 成交後策略的部位(多單為正、空單為負) |
訊息範例,填在快訊的訊息欄。
{"ticker": "{{ticker}}", "id": "{{strategy.order.id}}",
"action": "{{strategy.order.action}}", "contracts": "{{strategy.order.contracts}}",
"target": "{{strategy.position_size}}", "bar_time": "{{time}}"}
- 冪等鍵(idempotency key)的意思是:同一筆請求送幾次,結果都跟送一次一樣。做法是組一串「同一次觸發都相同、不同觸發都不同」的字,這裡用商品、委託 ID、買賣方向、K 棒時間四個欄位。
- {{timenow}} 在重送時會不會變,官方沒有寫,所以不拿它組冪等鍵。
- target 帶的是成交後應該有的部位,下單程式拿它跟帳戶實際部位比,只送差額(第六節)。
小結:訊息用 JSON,欄位裡至少要有組冪等鍵的資料和目標部位。
四、重送規則:一次觸發最多收到 4 筆
TradingView 說明中心〈Webhook resubmission〉的規定整理成下表。
| 接收端的回應 | 官方重送規則 |
|---|---|
| 500~599,504 除外 | 隔 5 秒重送,最多 3 次 |
| 504 | 不重送 |
| 其他狀態碼、逾時、連不上 | 重送規則沒有列,看快訊紀錄的錯誤訊息 |
例題:假設接收端已經把訊息交給下單程式,接著在回應前出錯,回了 500。5 秒後同一筆訊息再送來,沒有冪等鍵就會再下一次單。照最多重送 3 次算,最壞的情況是 1 口的訊號送出 4 口。
- 另外兩種重複,冪等鍵擋不住:同一個策略建了兩個快訊;指標快訊選了「每根 K 棒一次」,訊號在 K 棒中途出現又消失,之後又出現。這兩種要靠第六節的對帳。
- 策略快訊 3 分鐘內觸發超過 15 次會被停掉。這是 TradingView 那端的上限,迴圈寫錯時要靠自己的程式設下單頻率上限擋住。
小結:重送是為了讓訊息送得到,接收端要自己保證同一筆只處理一次。
五、接收端示意:Python 標準庫,擋重送、先回應再下單
這支接收端只用 Python 標準庫,在 Python 3.13 實際跑過。它檢查來源 IP、用 SQLite 記下收過的冪等鍵,把新訊息放進佇列後馬上回應。
import json, queue, sqlite3, threading
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
TV_IPS = {"52.89.214.238", "34.212.75.30", "54.218.53.128", "52.32.178.7"}
TEST_IPS = {"127.0.0.1"} # 只給本機測試,上線前拿掉
db = sqlite3.connect("seen.db", check_same_thread=False)
db.execute("CREATE TABLE IF NOT EXISTS seen (key TEXT PRIMARY KEY)")
lock = threading.Lock()
jobs = queue.Queue()
def first_time(key):
with lock:
try:
db.execute("INSERT INTO seen VALUES (?)", (key,))
db.commit()
return True
except sqlite3.IntegrityError:
return False
def worker():
while True:
msg = jobs.get()
# 這裡接自己的下單程式:先對帳,再算要送幾口
print("交給下單程式:", msg, flush=True)
class Hook(BaseHTTPRequestHandler):
def do_POST(self):
if self.client_address[0] not in TV_IPS | TEST_IPS:
return self.reply(403, "ip not allowed")
body = self.rfile.read(int(self.headers.get("Content-Length", 0)))
try:
msg = json.loads(body)
key = "|".join(msg[k] for k in ("ticker", "id", "action", "bar_time"))
except (ValueError, KeyError, TypeError):
return self.reply(400, "bad message")
if not first_time(key):
return self.reply(200, "duplicate")
jobs.put(msg)
self.reply(200, "queued")
def reply(self, code, text):
self.send_response(code)
self.end_headers()
self.wfile.write(text.encode())
threading.Thread(target=worker, daemon=True).start()
ThreadingHTTPServer(("0.0.0.0", 8080), Hook).serve_forever()
在本機用 curl 送了三次,結果如下。
| 送出的內容 | 回應 | 有沒有交給下單程式 |
|---|---|---|
| 第三節格式的 JSON(第一次) | 200 queued | 有 |
| 同一筆 JSON 再送一次(模擬重送) | 200 duplicate | 沒有 |
| 純文字 TXF1! Crossing 40000 | 400 bad message | 沒有 |
- 收過的重複訊息照樣回 200。回 5xx 會再引來重送。
- 冪等鍵存在 SQLite 檔,程式重開也記得;欄位設成 PRIMARY KEY,「查有沒有收過」和「記下來」一步完成,兩筆同時進來也只會有一筆成功。
- 這支聽 8080 埠,TradingView 只送 80、443:實際使用要放在有 HTTPS 憑證的反向代理(reverse proxy)後面。程式看到的來源會變成代理的 IP,所以白名單要改在代理那一層檢查。
- worker 那段只印出訊息,實際要接自己的下單程式。
小結:這支示意只處理「同一筆不要做兩次」,部位對不對要靠下一節。
六、斷線與對帳:送不到、送兩次都要對得回來
| 狀況 | 會發生什麼 | 處理方式 |
|---|---|---|
| 接收端當機 | 訊息送不到,快訊紀錄顯示錯誤 | 重開後先對帳,漏掉的訊號從快訊紀錄補查 |
| 下單程式跟期貨商斷線 | 訊息留在佇列裡 | 暫停下單、重連、查委託與部位,一致才恢復 |
| 冪等鍵擋不住的重複 | 收到兩筆內容不同的訊息 | 用 target 對帳,只送差額 |
| 快訊被停用或到期 | 不再送出 | 定時檢查快訊狀態 |
例題:假設策略成交後 target 是 1,也就是多單 1 口。
| 帳戶實際部位 | 差額 | 下單程式怎麼做 |
|---|---|---|
| 多單 1 口 | 0 | 不送單 |
| 0 口 | 買 1 口 | 送買進 1 口 |
| 多單 2 口 | 超過目標 | 停止下單,通知人工處理 |
- 斷線後的處理順序(暫停、重連、查詢、比對)和委託回報怎麼看,〈期貨券商 API 串接實務〉有完整表格;單日虧損熔斷、定時對帳、心跳通知在〈程式交易實盤風控怎麼設〉。
- 訊號本身會不會閃現,要從源頭處理:Pine Script 官方文件說,避免快訊重繪最簡單的方法是把頻率設成「每根 K 棒收盤一次」(Once per bar close),代價是要等 K 棒收完。策略預設只在 K 棒收盤時計算,除非用了 calc_on_every_tick = true。腳本寫法的檢查看〈用 ChatGPT、Claude 寫交易程式〉第四節。
小結:冪等鍵管「同一筆」,對帳管「部位對不對」,兩層都要有。
常見問題
TradingView 可以直接連期貨帳戶自動下單嗎?
官方說明中心〈How to autotrade using Pine Script strategies〉寫的是:策略交易只限回測模式,用券商帳戶自動執行策略目前還沒開放。快訊加 Webhook 能做到的是把訊號送出去,下單在自己的程式裡完成。
Webhook 可以送到家裡的電腦嗎?
網址要能從外面連到,而且只能用 80 或 443 埠;解析到本機或內部 IP 的網址會被擋。家裡的電腦還會遇到停電、斷網、系統更新重開機,主機放哪裡可以看〈程式交易實盤風控怎麼設〉的雲端主機段。
自動下單的帳戶要放多少錢?
上實單從最小口數開始,帳戶放到一口價值的三分之一以上,整體槓桿控制在三倍以下:假設台指期 40,000 點,微台一口價值 40 萬元,帳戶至少放約 13.3 萬元。可以用 opop.tw 的〈台指期真實槓桿計算機〉換成自己的口數試算。
延伸閱讀
- 期貨券商 API 串接實務:行情訂閱、委託回報、斷線重連與滑價控制
- 程式交易實盤風控怎麼設?單日虧損熔斷、委託逾時取消、對帳與雲端主機(VPS)配置
- 用 ChatGPT、Claude 寫交易程式:Pine Script、PowerLanguage、Python 能幫到哪、最常寫錯什麼
- 期貨程式交易怎麼開始?從回測、避免過度最佳化、API 下單到自動風控,一次看懂整個流程
- 量化交易是什麼?跟程式交易、演算法交易差在哪,台指期散戶做的是哪一種
- TradingView 社群腳本怎麼挑?看原始碼、檢查重繪(repaint),回測前先核對策略設定
- TradingView MCP 是什麼?讓 Claude、ChatGPT 直接讀圖表,官方工具、使用條款與資料延遲
你想投資美股嗎?試試從Firstrade開始
買賣美股、ETF、選擇權均享 $0 佣金,完全中文化介面並設有中文客服
來Firstrade開始你的海外交易吧!點擊下方圖片瞭解更多相關資訊
